NeoMutt 整体配置
本指南将引导你完成在 macOS 上配置邮件环境的整个过程，最终实现完全在终端中使用 NeoMutt 接收、查看、编辑、发送、回复、转发邮件。
配置环境如下：
- 操作系统：macOS Tahoe 26.0.1
- 终端命令行：iTerm2
- 文本编辑器：Neovim
- 邮件客户端：NeoMutt
- 管理联系人：khard
- 查看富文件格式的工具：w3m/zathura/imgcat
整个配置基于即时登录远程邮件服务器。当服务器邮件数量较多时，每次登录刷新邮件列表需要耗费一点时间，1000 封邮件的加载时间大约是几秒或十几秒的样子。
目录结构
为提高全套配置文件的可移植性，尽量把全部的配置文件放置在同一个目录下，主要的功能也采用模块化的配置文件。
bash
~/.config/neomutt/
├── neomuttrc # Main config, sources everything else
├── options # General settings (editor, options, etc.)
├── mappings # Keybindings and macros
├── mailcap # External program handlers (use env vars)
├── accounts/ # Account configs and signatures
└── themes/ # Theme configs其中，neomuttrc 是配置主要入口，文件内部引用另外的四个独立的配置文件：
optionsmappingsthemes/rebelot.neomuttrcmailboxes
配置了这四个文件之后，就可以在终端里顺畅地使用 NeoMutt 接收、查看、编辑、发送、回复、转发邮件，邮件客户端的基本功能已经具备。
最后的一个配置文件 mailcap 是在实现了最初的文本邮件的基本功能之后，再增加几个额外的功能，例如，在 NeoMutt 中查看 HMTL 格式的邮件，查看 PDF 格式的附件，查看图片格式的附件，等等。这个配置文件是在 options 内部被引用。
安装工具
在 macOS 系统上，我们使用 Homebrew 来安装所有必要的软件。打开你的终端，比如我使用的是 iTerm2，运行以下命令：
bash
brew install neomutt
brew install w3m zathura imgcat配置文件
按照建议的目录结构创建相应的目录和文件。
neomuttrc
主配置文件 ~/.config/neomutt/neomuttrc 作为主要入口，依次引入其他几个配置文件：
muttrc
# vim: set filetype=neomuttrc:
# Source general settings, mappings, and theme
source options
source mappings
# source themes/dracula.neomuttrc
source themes/rebelot.neomuttrc
source mailboxes主文件依次分别引入基本配置、快捷键、主题颜色、邮箱帐户。子目录 themes 下有多个主题可选，这里设置使用了 rebelot 主题；子目录 accounts 下有包含默认帐户 twine 在内的其他多个邮箱帐户，切换各个帐户的快捷键 F2、F3 定义在 mailboxes 里面。
options
muttrc
# vim: set filetype=neomuttrc:
# set help
# set help = yes
#
# unset help # No help bar at the top of Index
# set help = no # No help bar at the top of Index
# Used when creating an email
set tmpdir = /tmp/$USER/neomutt # Where to keep temp files
set editor = "nvim"
set imap_check_subscribed
# Pager View Options
set pager_index_lines = 10 # show 10 lines of Index when Pager is active
set pager_context = 5 # lines of context between pages
set pager_stop
set smart_wrap
set menu_scroll
set tilde
set markers = no # do not show plus sign for wrapped lines in the pager
set allow_ansi
# Main options
set edit_headers # show headers when composing
set askcc # ask for CC:
set text_flowed = yes
set beep_new # bell on new mails
set pipe_decode # strip headers and eval mimes when piping
set envelope_from
set collapse_all
set uncollapse_jump
set sleep_time = 0
set mark_old = yes # marking new, unread emails as old when you exit a mailbox
set mime_forward = no # forward attachments as part of body
set forward_attachments = yes
set wait_key = no
set fast_reply # skip to compose when replying
set fcc_attach # save attachments with the body
set forward_format = "Fwd: %s" # format of subject when forwarding
set date_format = "%d.%m.%Y %H:%M"
set send_charset = "utf-8"
set assumed_charset = "utf-8:us-ascii"
set reply_regexp = "^(([Rr][Ee]?(\[[0-9]+\])?: *)?(\[[^]]+\] *)?)*"
set quote_regexp = "^( {0,4}[>|:#%]| {0,4}[a-z0-9]+[>|]+)+"
set forward_quote # include message in forwards
set reverse_name # reply as whomever it was to
set include # include message in replies
set mail_check = 10
set count_alternatives = yes
set auto_tag
set auto_subscribe
set flag_safe
set browser_sort = unsorted
### index sorting
# set use_threads = reverse
# set sort = last-date
set sort = reverse-date
### sidebar
set sidebar_format = "%B %<N?(%N)>%* %S"
set mail_check_stats = yes
set mail_check_stats_interval = 60
# set sidebar_visible
set sidebar_width = 30
set sidebar_folder_indent = no
set sidebar_next_new_wrap = yes
set sidebar_short_path = yes
### headers
ignore *
unignore from: to: cc: date: subject: x-label:
unhdr_order *
hdr_order from: to: cc: date: subject: x-label:
### Attachments
set mime_type_query_command = "file --mime-type -b %s"
# set mailcap_path = $HOME/.config/neomutt/mailcap
set mailcap_path = ~/.config/neomutt/mailcap
# set display_filter = "tac | sed '/\\\[-- Autoview/,+1d' | tac"
# auto_view application/ics
# auto_view text/calendar
# auto_view text/plain
# auto_view text/html
# auto_view application/pgp-encrypted
# alternative_order text/calendar text/html text/enriched text/plain text/*
# Set preferred view modes (used before but now replaced by the upper section)
# view html automatically
auto_view text/html text/calendar application/ics
alternative_order text/html text/plain text/enriched text/*
set timeout = 30
### These are the settings not categorized yet
set forward_decode # decode when forwarding
set attribution = "On %d, %n wrote:"
set reply_to # reply to Reply to: field
set sig_dashes = no # no default `-- ` dashes before signature
set sig_on_top = yes # signature shall always stick to your email body
set confirmappend = no # don't ask, just do!
set quit # don't ask, just do!
set thorough_search # strip headers and eval mimes before searching
# Status bar, date format, finding stuff etc.
set status_chars = " *%A"
set status_format = "[ Folder: %f ] [%r%m messages%?n? (%n new)?%?d? (%d to delete)?%?t? (%t tagged)? ]%>─%?p?( %p postponed )?"
set sort_re
set charset = "utf-8"
set arrow_cursor = "no"
# set header_cache = ~/.cache/mutt
# set message_cachedir = ~/.cache/mutt
set header_cache = ~/.cache/neomutt/headers
set message_cachedir = ~/.cache/neomutt/bodies
set query_command = "khard email --parsable --search-in-source-files '%s'"注意要点如下：
editor设置为调用 Neovim 用以编辑邮件头部和主体内容query_command设置使用Tab键搜索和补全联系人的电邮地址：主要使用在当编辑邮件头部的表单区域，例如To:/Cc:/Bcc:等位置，需要添加电邮地址的时候，随便打几个你依稀记得的收件人姓名或者电邮地址的若干字母，然后按Tab键就可一键补全，非常快捷实用
mappings
muttrc
# vim: set filetype=neomuttrc:
# Read more at https://neomutt.org/guide/reference#4-%C2%A0functions
bind index L limit
macro index x "<limit>all\n" "show all messages (undo limit)"
bind index h noop
bind pager,attach h exit
bind index l display-message
bind pager l view-attachments
bind browser h goto-parent
bind browser l select-entry
# Sidebar
bind index,pager B sidebar-toggle-visible
bind index,pager \Cp sidebar-prev
bind index,pager \Cn sidebar-next
bind index,pager <Return> sidebar-open
# Email completion bindings
bind editor ^T complete
bind editor <Tab> complete-query
bind editor <space> noop
bind attach <space> view-mailcap
macro index,pager A "<pipe-message>khard add-email --headers=from,cc --skip-already-added<return>"
bind index,pager i noop
bind index,pager,attach,browser,query,alias,compose q exit
bind index t tag-entry
bind index T tag-thread
bind index * tag-pattern
# Moving around
bind index,pager,attach,browser g noop
bind index,attach,browser gg first-entry
bind index,attach,browser G last-entry
bind pager gg top
bind pager G bottom
bind pager k previous-line
bind pager j next-line
bind pager <Up> previous-line
bind pager <Down> next-line
# Generic Menu
#
# The generic menu is not a real menu, but specifies common functions
# (such as movement) available in all menus except for pager and editor.
#
# bind index j next-entry
# bind index k previous-entry
# bind index <Up> next-entry
# bind index <Down> previous-entry
# Jump previous/next emails in pager view
bind pager J next-entry
bind pager K previous-entry
# 2025-12-02 stopped here
#
# Scrolling
bind attach,browser,pager,index \CF next-page
bind attach,browser,pager,index \CB previous-page
bind attach,browser,pager,index \Cu half-up
bind attach,browser,pager,index \Cd half-down
bind browser,pager \Ce next-line
bind browser,pager \Cy previous-line
bind index \Ce next-line
bind index \Cy previous-line
# Delete
bind index,pager d noop
bind index,pager dd delete-message
bind index,pager D purge-message
bind index u undelete-message
# Mail & Reply
bind index,pager r noop
bind index,pager gr group-reply
bind index,pager rl list-reply
bind index,pager ro reply
# Threads
bind browser,pager,index N search-opposite
bind pager,index dT delete-thread
bind pager,index dt delete-subthread
bind pager,index gt next-thread
bind pager,index gT previous-thread
bind index z noop
bind index za collapse-thread
bind index zA collapse-all
bind index zz current-middle
bind index zt current-top
bind index zb current-bottom
# List files in $HOME with fzf and send them to attachments
# Use Tab to select multiple files and press Enter to confirm
macro compose \Ca ":source ~/.config/neomutt/bin/attach_browser_fzf.sh|<enter>"配置签名
每个帐户使用独立的签名文件，在相应的帐户配置文件中通过 set signature 来指定。
例如，twine 帐户的签名在 ~/.config/neomutt/accounts/twine-signature 中定义，并在 ~/.config/neomutt/accounts/remote-twine 中通过以下命令引用：
set signature = "twine-signature"管理联系人
安装 khard
bashbrew install khard在 NeoMutt 配置文件内添加关于 khard 的配置：
# ============================================================================= # 通讯录 (Address Book) # ============================================================================= # 设置 khard 为地址查询命令 set query_command = "khard email --parsable --search-in-source-files '%s'" bind editor <Tab> complete-query # 在邮件列表或邮件内容界面按 "A" 键，将发件人添加到 khard macro index,pager A "<pipe-message>khard add-email<enter>"这个配置成功之后，在撰写邮件、添加收件人时，只需先简单敲入几个字符，例如
mich，然后使用Tab可以自动补全收件人Michael的电邮地址mchui@example.com（当仅有一个搜索匹配时），或弹出下拉列表供选择多个待选电邮（当存在多个搜索匹配时）。
FAQ
- How to re-edit a draft email in NeoMutt? By default, use
Rkey to recall a postponed message. - What is the difference between
delete-messageandpurge-message? a.delete-messagedelete the current entry (into Trash) b.purge-messagedelete the current entry, bypassing the trash folder - To delete a message: a. Navigate to the message you want to delete in the index. b. Press
dd. The message will be marked with a 'D' flag. c. To move the message to the trash folder, you need to sync the mailbox. The default keybinding for this is$. After pressing$, the message will disappear from in inbox and be moved to the "+Trash" folder. - To undelete a message: a. Go to the Trash folder b. Select the message, press
tto tag the message c. Presss(for "save message"). At the "Save to mailbox:" prompt, type+INBOXand press Enter. - How to show your mailboxes in NeoMutt? Method 1: Using the mailbox browser In the index/pager view, press
cto open the mailbox browser. To see a list of all mailboxes, press?. These two steps are now combined into just oney. Use the arrow keys to navigate the list and pressEnterto switch to the selected mailbox. - How to add attachments to your email message?
Core Interface Components
1. index
The main message list showing your mailbox contents. It displays headers (sender, subject, date, flags) in a tabular format.
Purpose: Navigation and management of email messages.
2. pager
The message viewer that displays the full content of a selected email, including headers, body, and attachments.
Purpose: Reading email content without opening external applications.
3. attach
The attachment menu that appears when viewing messages with MIME attachments. Allows you to save, view, or pipe attachments to external programs.
Purpose: Managing email attachments directly within NeoMutt.
4. browser
The file browser used for selecting mailboxes (folders), files for attaching, or directories when saving attachments.
Purpose: Filesystem navigation within NeoMutt.
5. query
The interface for querying external address books (LDAP, query_command, etc.) when addressing emails.
Purpose: Searching for contacts/addresses.
6. alias
The alias menu for selecting from your configured email aliases (often used as an address book).
Purpose: Quick addressing using predefined contact aliases.
7. compose
The composition screen where you write new emails, replies, or forwards. Includes editor, header fields, and attachment management.
Keybinding Syntax Components
bind [mode] [keysequence] [function] [description]
macro [mode] [keysequence] [actionstring] [description]