1. 为什么是iTerm2：换掉系统自带终端之前，先搞清楚它值不值得
1.1 自带终端真正让人难受的地方
在Mac上折腾终端这件事，一旦开始就停不下来。我先说结论：如果只是偶尔打开命令行跑一两条命令，系统自带的“终端”确实够用；但如果你要天天跟服务器、脚本、日志、编译任务打交道，iTerm2值得你专门花半小时好好配置一次。很多人第一次打开iTerm2可能会问，它和系统终端看起来不都是黑底白字吗？差别在哪？差别主要在“用起来”而不是“看起来”。
系统自带终端最明显的问题是窗口管理。开发的时候经常需要同时看两个目录下的日志，或者一边编辑配置文件一边观察命令输出。自带终端虽然支持多标签页，但标签页之间只能来回切换，没办法像编辑器那样在一个窗口里左右分屏。手动把两个窗口并排摆也不是不行，但每次换显示器、换工作目录都要重新调整位置，时间一久就很烦。其次是配色和字体，默认的白底黑字在光线暗的环境里非常刺眼，想换主题需要手动去改配置，改完也不一定好看。还有一个被很多人忽略的细节是粘贴安全问题。自带终端会把剪贴板内容原封不动丢进命令行，万一复制了一段带换行的多行命令，可能还没反应过来就回车执行了。
1.2 iTerm2 的核心优势：分屏、热键、粘贴保护一个不少
iTerm2真正吸引人的地方不是花哨，而是把终端里高频的小操作都做到了顺手级别。第一就是分屏，iTerm2可以用快捷键把一个窗口切成左右或上下多个窗格，窗格之间独立滚动，甚至支持同步输入。这个功能在排查线上问题时特别实用：一边开一个窗格看服务日志，一边在另一个窗格敲命令，鼠标都不用挪。第二是全局热键窗口，设置好之后，在任何应用里按一个组合键就能呼出终端，输完命令再按一下收起。这个体验很像在IDE里按快捷键打开命令面板，但终端窗口是全局的，真正做到随叫随到。第三是粘贴保护，当剪贴板内容里包含换行符时，iTerm2会先弹窗问你确认，避免误执行多行命令。这个功能看着简单，实际能挡住不少事故。
它还有即时回放、智能选中、状态栏、配色预设、会话保存这些能力。如果你刚接触命令行，这套配置能直接降低前期的挫败感；如果你是老手，分屏和热键窗口能实打实节省时间。下面我开始讲怎么从零把iTerm2配置成一天离不开的效率入口。
2. 安装与基础环境准备
2.1 官网安装和Homebrew安装怎么选
iTerm2的安装方式很成熟，两条路都走得通。第一种是直接从官网下载zip压缩包，解压后把iTerm2.app拖进“应用程序”文件夹。首次打开时，如果提示“无法验证开发者”之类的信息，不要慌，这是macOS的Gatekeeper机制在检查应用来源，不是软件本身出了问题，右键软件图标选择“打开”即可绕过。第二种方式适合已经装了Homebrew的用户，在终端里执行一条命令：
brew install --cask iterm2这种方式的好处是升级方便，以后想更新，命令行里跑一条命令就完成。两种方式装完之后，按住Command键或直接用Spotlight搜索iTerm2就能打开。我个人的习惯是优先用Homebrew管理，因为后面配置Zsh、安装字体也会依赖Homebrew，统一用命令行管理比较省事。如果只是偶尔用终端，官网下载反而更直观，没有多余依赖。需要注意，如果之前装过旧版本iTerm2，用新版本覆盖安装是可以的，配置文件一般会保留。
2.2 把iTerm2设置成默认终端
装好之后，很多人做的第一件事是让系统默认用iTerm2打开终端操作。打开iTerm2，按Command+,进入偏好设置，在General -> Startup这个页面里找到“Default Terminal”相关的按钮，点击“Make default terminal”。设置完成后，在访达里右键一个文件夹，选择“新建位于文件夹位置的终端窗口”或类似入口时，打开的就是iTerm2而不是系统终端。macOS版本不同，界面文字可能略有差异，但核心按钮不变。
这里有一个小坑：有些用户找不到这个按钮，或者点了以后没有反应。遇到这种情况，先重启一次iTerm2再试。只要按钮成功生效，你在访达里打开终端的操作就会统一走iTerm2，文件管理和命令行之间的衔接会自然很多。这个步骤不是必须的，但建议做一下，尤其是你平时习惯用访达浏览文件、在目录里直接敲命令的场景。
2.3 第一轮偏好设置：窗口、滚动记录和半透明
装好iTerm2后，先不要急着找各种主题，先把基础偏好设置过一遍，后面再折腾外观会顺手很多。打开Preferences -> Appearance，可以把Theme调成Dark或Minimal。Minimal会隐藏掉窗口的标题栏，让终端看起来更干净，我比较推荐。接着到Profiles -> Window，这里可以调整窗口的透明度、背景模糊和窗口风格。我习惯把透明度调到10%左右并开启Blur，这样终端窗口和背景App叠加时依然能看清文字，又不会显得太死板。窗口风格选“No Title Bar”，和热键窗口配合起来尤其好看。
在Profiles -> Terminal页面里，建议把Scrollback lines调大。默认设置好的滚动行数可能只有1000行，看长日志时很容易翻不到之前的输出。可以直接开启Unlimited scrollback，或者至少调到10000行。另外在Profiles -> Session里，有一个“Dim inactive split panes”选项，开启后多个窗格并存时，当前活跃窗格保持高亮，其他窗格自动变暗。视觉上能一眼看出自己在操作哪个窗格，多开的时候很好用。
2.4 配色导入：用最快的方式换上一套顺眼主题
iTerm2用.itermcolors文件来管理配色主题，网上很多开源配色项目都提供现成文件。拿到文件后有两种导入方式：一种是直接双击.itermcolors文件，系统会用iTerm2打开并导入；另一种是在Preferences -> Profiles -> Colors页面，点击Color Presets下拉菜单里的Import，然后选中下载好的文件。导入之后，还需要在同一下拉菜单里把刚刚导入的主题选一次，它才会真正套用到当前Profile。
这里有个非常常见的误解：很多人导入成功后，终端颜色根本没变化，原因是当前使用的Profile不对，或者Color Presets下拉菜单里选中的不是刚刚导入的主题。你需要先确认Preferences左侧的Profiles列表里选中的是你的默认配置，然后确认Colors页面里的Color Presets已经选中目标主题。配色方面，我比较推荐Solarized Dark、Dracula和One Dark这类对比度不刺眼的主题。不过别指望颜色选完就万事大吉，后面换了Zsh主题后，有些图标和颜色会被覆盖，那是下一个步骤要处理的问题。
3. 终端环境升级：Zsh + Oh My Zsh 的完整配置
3.1 先确认当前shell是不是Zsh
macOS近年来已经把默认shell切换成了Zsh，但很多从Linux迁移过来的用户，或者一直没重新登录的旧系统，终端里可能还在用Bash。做配置之前，先运行一条命令确认：
echo $SHELL如果输出是/bin/zsh，说明已经是Zsh，直接进入下一小节。如果输出是/bin/bash，说明还在用Bash，需要手动切换。先确认Zsh已经安装，macOS一般自带，如果没有，可以通过Homebrew安装：
brew install zsh然后用chsh命令修改默认shell：
chsh -s /bin/zsh如果是通过Homebrew自定义安装的Zsh，路径可能是/usr/local/bin/zsh或/opt/homebrew/bin/zsh，以which zsh的输出为准。切换后需要重启终端或者重新登录用户身份。为什么一定要换成Zsh？因为Zsh的补全体验、主题和插件生态比Bash丰富太多，尤其是配合Oh My Zsh之后，很多在Bash里要手动实现的增强功能，无限接近开箱即用。
3.2 安装Oh My Zsh：管理配置的地基
Oh My Zsh是一个管理Zsh配置的框架，它把主题、插件、别名组织成一套约定俗成的结构。官方提供了一句安装命令，在终端执行：
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"这行命令会下载一个安装脚本并执行。执行过程中，脚本会提示你设置Zsh为默认shell，如果之前已经切好了，这里一般不会再问。安装完成后，它会在家目录下生成一个.zshrc文件，以及一个隐藏的.oh-my-zsh目录。以后所有终端配置，基本都在.zshrc里改。
打开.zshrc，能看到ZSH_THEME和plugins这样的配置项。刚开始建议只改主题和少量插件，不要一上来就把网上的完整配置粘贴进去。这里要特别提醒：如果不小心把.zshrc改坏了，最简单的恢复办法是找到Oh My Zsh安装时生成的备份文件，通常是.zshrc.pre-oh-my-zsh。我刚开始折腾时，养成了一个习惯：每次改动.zshrc之前，先复制一份到改名文件。这个习惯后来帮我从各种配置事故里快速脱身，非常值得保留。
3.3 主题选择：从默认主题到Powerlevel10k
Oh My Zsh默认主题叫robbyrussell，绿色箭头加目录名，简洁但信息密度偏低。想体验丰富一点的，先把ZSH_THEME改成agnoster，重启终端后提示符会变成带三角形箭头的折线样式，很多技术截图里就是这种效果。不过agnoster在中文环境下容易出现字符重叠或乱码，因为提示符里的特殊符号需要额外字体支持，下一节会专门讲。
如果想要更强的视觉和功能，直接用Powerlevel10k。这个主题的提示符支持显示当前路径、Git分支、上一条命令耗时、执行状态、电池状态等，而且渲染速度非常快。安装方式是通过Oh My Zsh的插件目录手动克隆仓库：
git clone https://github.com/romkatv/powerlevel10k.git $ZSH_CUSTOM/themes/powerlevel10k然后编辑.zshrc，把ZSH_THEME这一行改成：
ZSH_THEME="powerlevel10k/powerlevel10k"重新打开终端，第一次运行时会进入配置向导，按提示选择字体风格、颜色方案、提示符样式等。配置向导最后会生成一个~/.p10k.zsh文件，之后想微调，直接改这个文件即可。Powerlevel10k还支持Instant Prompt模式，开启后终端启动时先显示基础提示符，其他内容后台加载，体感上几乎无等待。我用这个主题很长一段时间，觉得它是命令行体验里最有性价比的一次升级。
3.4 高频插件：自动提示与语法高亮
配完主题，终端还缺两个很关键的能力：输入命令时的历史自动补全，以及输入内容时实时反馈是否合法。这两个能力分别对应zsh-autosuggestions和zsh-syntax-highlighting。先安装第一个：
git clone https://github.com/zsh-users/zsh-autosuggestions $ZSH_CUSTOM/plugins/zsh-autosuggestions再安装第二个：
git clone https://github.com/zsh-users/zsh-syntax-highlighting $ZSH_CUSTOM/plugins/zsh-syntax-highlighting然后在.zshrc里找到plugins这一行，改成：
plugins=(git zsh-autosuggestions zsh-syntax-highlighting)保存后执行source ~/.zshrc让配置生效。生效后，当你输入命令时，旁边会出现灰色的历史命令余下部分，按方向键右键即可补全；当你输入一条不存在的命令时，命令名会变成红色，正确的命令是绿色。这两个插件用了就回不去。
有一个顺序细节很关键：zsh-syntax-highlighting尽量放在plugins列表的最后一位，否则高亮功能可能被其他插件覆盖或者加载不正常。插件数量也不要堆太多，每加一个都会拉长启动时间。我实际用下来，git、自动建议、语法高亮这三个再加上少量自定义别名，已经很够用了。
3.5 别名、PATH、历史记录这些细节
配置文件里除了主题和插件，真正日常使用频率很高的是别名和PATH设置。我习惯在.zshrc的底部区域先规划好别名：
alias ll='ls -lah' alias la='ls -Al' alias zshconfig='vim ~/.zshrc' alias reload='source ~/.zshrc' alias cl='clear'PATH设置尤其重要，尤其是用Homebrew安装软件后，需要让Homebrew的bin目录排在前面。可以在.zshrc里加：
export PATH="/opt/homebrew/bin:$PATH"Apple Silicon机器上Homebrew路径通常是/opt/homebrew/bin，Intel机器是/usr/local/bin，按实际情况填写。这段要放在比较靠前的位置，避免后面用which查找命令时路径顺序错误。再一个值得设置的是历史记录共享：
HISTFILE=~/.zsh_history HISTSIZE=5000 SAVEHIST=5000 setopt share_history设置之后，多个终端窗口的历史命令是相互同步的，在A窗口敲过的命令，B窗口也能用方向键翻到。最后是语言环境。如果本地终端里中文显示成乱码，可以在.zshrc加入：
export LANG=zh_CN.UTF-8不过如果你经常SSH到远程英文环境的机器，这个设定可能造成远端locale不一致，所以要看实际场景决定。
4. 颜值与效率细节：字体、快捷键、分屏、热键窗口
4.1 字体选不对，所有主题都白搭
很多人在安装Powerlevel10k或agnoster之后，发现提示符里的三角箭头变成了方块或问号，这就是字体没选对。普通终端字体没有为Powerline符号专门设计字形，所以那些特殊字符显示不出来。解决办法是安装Nerd Fonts方案里的字体，或者直接用Powerlevel10k自带的推荐字体。我自己用下来比较顺手的几款是MesloLGS NF、FiraCode Nerd Font和JetBrainsMono Nerd Font。通过Homebrew安装很省事：
brew install --cask font-meslo-lg-nerd-font brew install --cask font-firacode-nerd-font brew install --cask font-jetbrains-mono-nerd-font装完字体后，在iTerm2的Preferences -> Profiles -> Text里，点击Font区域的Change Font，选择新装的Nerd Font。同时建议把“Use a different font for non-ASCII characters”也勾上，并把非ASCII字体设置为同一款Nerd Font或者一个支持中文的字体。这样Powerline符号能正常显示，中文也不容易出现渲染问题。字体大小我一般放在12号左右，太小长时间看会累，太大在分屏时又会浪费空间。如果设置完还乱码，多半是Profile没选对，或者终端会话没有重启。
4.2 快捷键：把分屏和切换做到肌肉记忆
iTerm2默认快捷键的设计已经比较合理，但很多人不知道。最常用的分屏快捷键：Command + D是垂直分屏，也就是左右分成两个窗格；Command + Shift + D是水平分屏，上下分成两个窗格。分屏之后，用Command + [ 或 Command + ] 在窗格之间循环切换，也可以用Command + Option + 方向键精确控制。
打开新标签页是Command + T，在多个标签页之间切换用Command + 数字键，第一个Tab按1，第二个按2。在终端输出里搜索内容用Command + F，支持正则，海量日志时很有用。即时回放用Command + Option + B，它能把终端内容往回倒，遇到输出跑太快没看清楚的场景能救急。
这些快捷键如果和系统其他软件冲突，可以在Preferences -> Keys -> Key Bindings里自定义。我个人的经验是不要贪多，先记住分屏和切换，其他快捷键用到再查。刚上手时想一次性掌握全部快捷键，反而容易手忙脚乱。
4.3 热键窗口：全局呼出终端的利器
热键窗口是iTerm2不可替代的功能之一。它的表现是：你在任何应用界面，按一个组合键，iTerm2就能从屏幕边缘弹出，再按同一个键就收起，像系统级插件一样，没有窗口边框。设置方法在Preferences -> Keys -> Hotkey，点击“Create a Hotkey Window”，然后按下你想用的组合键。
我在这台Mac上选了Option + Space。macOS的Spotlight默认是Command + Space，中文输入法通常占用的是Control + Space或Caps Lock，Option + Space很少被其他软件占用，冲突概率低。启用后，热键窗口会默认在屏幕顶部以横幅样式弹出。你可以继续调整它的背景透明度、标签栏是否显示等，让它更轻盈。
这个功能适合随时执行一条命令，不需要切回桌面，也不需要在多个窗口里翻找iTerm2。配合分屏之后，基本可以替代大部分“切换窗口”的低效操作。如果你经常遇到“突然需要跑个命令看看状态”的场景，热键窗口是提升效率最直接的手段。
4.4 状态栏：让终端窗口自己“开口说话”
iTerm2较新版本支持在窗口底部显示一条状态栏，可以放CPU占用率、内存占用、当前目录、Git分支、最近命令耗时等信息。打开方式是Preferences -> Profiles -> Session，找到Status bar相关选项，勾选Show status bar，然后点击Configure Status Bar，在弹出界面里添加组件，右侧实时预览。
我比较推荐的组件是Git branch和Current directory。多个分屏窗口同时工作时，状态栏能避免你忘记自己正在哪个分支、哪个目录。如果觉得状态栏占地方，可以勾选Auto hide status bar，终端空闲时自动隐藏，只在触发操作时显示。状态栏顶部还可以放Activity indicator，有后台任务运行时会显示提示，跑长时间编译任务时很好用。
状态栏的配置很个人化，不一定全都要。我自己默认只开当前目录、Git分支和CPU占用，其他信息需要看时再手动加。配置完之后，每个终端窗口的信息可读性会高出一大截。
5. 配置同步与迁移：换新Mac时不用从头再来
5.1 用iTerm2的动态配置保存功能
折腾完iTerm2，它会变成一个很顺手的工具。但还有一个现实问题摆在面前：如果换了一台新Mac，或者系统重置，能不能快速恢复？iTerm2提供了一个非常方便的动态配置保存选项。在Preferences -> General -> Preferences页面里，可以看到“Load preferences from a custom folder or URL”。你可以指定一个本地文件夹存放配置，比如~/dotfiles/iterm2，并勾选Save settings让它自动保存。以后任何偏好设置的修改，都会被程序自动导出到指定目录的plist文件里。
换新机器时，只要在iTerm2里把路径指到同一个文件夹，就能加载同一套配置。如果你用了同步网盘，多台Mac之间甚至可以实时同步。不过同步前要想清楚，网盘在多台设备间同时打开时可能会把旧的配置文件同步覆盖，最好在做大幅度调整之前先关闭自动同步。iTerm2还有一个手动导出入口，在General -> Preferences页面里可以执行Save All Settings或者Copy plist to custom folder，总之把配置落盘成文件再迁移是最稳的。
5.2 Dotfiles管理：把Zsh配置文件纳入版本管理
iTerm2自己管理的配置解决外观和窗口行为，Zsh相关的配置则要单独处理。我的做法是把~/.zshrc、~/.p10k.zsh这类文件放进一个dotfiles目录，然后用符号链接把家目录里的配置入口指向版本管理目录。例如：
mkdir -p ~/dotfiles mv ~/.zshrc ~/dotfiles/.zshrc ln -s ~/dotfiles/.zshrc ~/.zshrc接下来就可以用Git之类的工具管理这个目录。以后改动配置，记录到dotfiles仓库里，每次到新机器上只需要克隆仓库、重新建好符号链接、再安装一遍Oh My Zsh和插件，配置就回来了。有人可能会问，直接拷贝.zshrc行不行？当然也可以，但符号链接的好处是，你修改的真正文件在dotfiles目录里，不容易漏备份。如果你不想用Git，也要定期把.zshrc备份到云盘或移动硬盘。我见过太多人配置了半年，结果电脑出问题后全部从头再来，这种痛苦经历过一次就会理解备份的价值。
5.3 写一个可重复执行的配置脚本思路
如果每次装完系统都要手动跑一堆安装命令，其实效率并不高。可以把前面所有安装步骤压缩进一个脚本，新机器上执行一次就完成大半。脚本的核心思路是：先装Homebrew，再用brew安装iTerm2和字体，接着安装Oh My Zsh，然后克隆Powerlevel10k和几个插件，最后用符号链接把配置指到正确位置。下面给一个示意结构：
#!/bin/bash # 一键配置终端环境（示意） export ZSH_CUSTOM=${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom} brew install --cask iterm2 brew install --cask font-meslo-lg-nerd-font sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" git clone https://github.com/romkatv/powerlevel10k.git $ZSH_CUSTOM/themes/powerlevel10k git clone https://github.com/zsh-users/zsh-autosuggestions $ZSH_CUSTOM/plugins/zsh-autosuggestions git clone https://github.com/zsh-users/zsh-syntax-highlighting $ZSH_CUSTOM/plugins/zsh-syntax-highlighting ln -sf ~/dotfiles/.zshrc ~/.zshrc脚本里没有设置主题和插件列表，因为那部分依赖你实际的.zshrc内容，真实使用时会加条件判断。这里想表达的是，配置过程不能只停留在“改好就行了”，把它变成可重复执行的资产，才是折腾终端的最终目的。执行完脚本后，新机器上第一次打开终端可能还会要求运行p10k configure，这很正常，因为主题配置向导需要人机交互。把这套流程走完，换机成本基本控制在半小时以内。
6. 常见问题与排查技巧实录
6.1 导入配色后界面没有变化
这个问题绝大多数情况下是因为当前使用的Profile不对。iTerm2允许你建立多个Profile，每个Profile可以拥有独立的字体、配色、快捷键布局。如果你在Profiles列表里选中了A Profile，却在B Profile的Colors页面导入了主题，界面上当然不会变。遇到这种情况，先确认当前正在使用的Profile是哪一个，然后到Colors的Color Presets里重新选择主题。
还有一个细节容易被忽略：有些主题导入后，需要调节Terminal里的Minimum contrast参数。它控制文字与背景的最小对比度，如果觉得文字蒙了一层灰，可以适当调高这个值。如果调色后整体颜色和预期差太远，不妨换一个主题试试，不同主题在不同Profile上的表现会有细微差异。
6.2 安装Powerlevel10k后图标还是方框
排在第一位的仍然是字体问题。确认iTerm2当前Profile的Font区域确实选择了Nerd Font，并且“Use a different font for non-ASCII characters”里也选了一款合适的字体。因为Powerlevel10k提示符里的分支图标、时钟图标都属于特殊字符，普通英文字体没有包含这些字形。安装多个Nerd Font后，注意别让系统默认字体接管特殊字符，最好在iTerm2设置里统一把非ASCII字体也指定为Nerd Font。
如果字体设置没问题，就在终端运行p10k configure，重新走一遍配置向导，它会按你选择的字体重新生成合适的图标类型。做完这一步，大部分乱码问题能解决。如果字体和向导都试过还是方框，可以考虑重启一次iTerm2，因为某些字体资源需要在App重启后才完全载入。
6.3 执行source ~/.zshrc时报command not found
这个提示说明.zshrc里引用了某个没有安装或路径不对的命令，最常见的原因是插件问题。检查plugins这一行里的插件目录名是否与克隆时的目录名一致，比如zsh-autosuggestions目录名不能写错。另一个常见错误是先把插件加入了plugins列表，但还没有执行git clone，导致Oh My Zsh找不到对应目录。还有可能是自己加的alias或函数名和系统命令重名，干扰了正常命令解析。
排查思路是先把.zshrc里最近新增的内容注释掉，然后分段执行source，看具体是哪一段报错。不要小看这个问题，.zshrc加载出错后不会立刻影响当前终端，但新开窗口时提示符会变得很难看，甚至长时间卡住不加载完整环境。
6.4 终端启动变慢怎么办
插件数量越多，Zsh启动越慢，这是不可避免的。想量化启动耗时，运行：
time zsh -i -c exit这行命令会输出Zsh以交互模式启动并退出的总耗时。如果接近1秒甚至更久，就要考虑精简。先看plugins里有没有装了但实际不用的插件，比如z、history-substring-search这些，能裁就裁。其次看主题，Powerlevel10k本身渲染很快，反而是某些老主题因为要执行外部程序，会拖慢启动。
Powerlevel10k的Instant Prompt功能记得开启，它能让终端先出现基础提示符，其余后台加载延后，体感会明显变快。如果用了iTerm2的状态栏，状态栏本身不会显著影响启动，但状态栏上的组件如果自动刷新太频繁，也可能造成一段时间的高CPU占用。
6.5 iTerm2窗口偶发卡顿和渲染问题
较新的硬件上如果感觉iTerm2滚动不流畅，可以检查渲染引擎。在Preferences -> Appearance -> General里找到渲染引擎选项，优先选择Metal作为Preferred rendering engine。Metal渲染在滚动和大量文本输出的场景下，流畅度优势很明显。窗口透明度和模糊效果开得太高，也会带来额外性能开销，全屏运行且需要跟服务器长交互时，建议适当降低特效。
还有一个偶发问题是字体渲染模糊，外接普通分辨率的显示器时比较常见。这种多半和缩放设置有关，而不是终端软件本身。试着把字体大小调到整数像素，例如12号或13号，会比11.5这种半整数看起来边缘更清晰。
6.6 中文字符显示与locale问题
中文乱码要分两种情况看：本地终端乱码，还是SSH到远程服务器后乱码。本地乱码，优先检查字体，确认非ASCII字体选的是支持中文的字体，比如PingFang SC。其次是环境变量，在.zshrc里加export LANG=zh_CN.UTF-8，让终端进程使用UTF-8编码。如果远程SSH也乱，问题多半在远程服务器的locale设置，本地加LANG不一定有用，需要在远程机器上调整对应配置。
我建议不要在.zshrc里强行写入单一语言环境。因为同一份配置可能在本地和远程都会加载，反而可能引发不一致。更稳妥的做法是只在本地配置好，远程的locale交给对应服务器的管理流程去处理。
6.7 多行粘贴提示这个功能千万别关
写到最后，想提醒一个很多人忽略的安全细节。iTerm2默认在检测到剪贴板内容包含换行符时，会弹出一个提示，询问你是要原样粘贴还是转义后粘贴。这个功能默认开着，但有些教程为了让自动化脚本粘贴方便，会引导大家把“Ask for confirmation when pasting multi-line text”这个选项关掉。如果你的工作流里有大量手工粘贴脚本，关掉确实顺滑，但同时也会失去一道保护屏障。我个人建议保留它，终端里误粘贴带来的损失比多按一次回车要大得多。如果觉得每次都被拦截很烦，可以只在偏脚本化的专用Profile里关闭，日常使用的默认Profile继续开着，这个小取舍长期看是值得的。
最后再分享一个我的实操习惯：配置完成之后，把~/.zshrc、~/.p10k.zsh和iTerm2导出的配置文件统一放进同一个备份目录，每次调整前复制一份。遇到解释不了的奇怪问题，对比备份能帮你快速定位，我在实际使用中就靠着这个习惯省下过不少时间。如果你也想把终端收拾得舒服一点，这套流程值得完整跑一遍。
