为什么 zsh 启动缓慢(以及如何修复)

你打开一个新的终端标签页。然后等待。一秒过去了,两秒,也许三秒。你的 zsh 提示符终于出现了。这种令人沮丧的延迟并不是 shell 本身的问题——几乎总是你的配置造成的。

原生的 zsh 安装启动时间大约在 50-100 毫秒。当启动时间膨胀到数秒时,罪魁祸首是可预测的:补全系统开销、同步插件加载、重量级主题,以及像 nvm 或 pyenv 这样的语言版本管理器。本指南将向你展示如何识别真正缓慢的部分,并在不重写整个配置的情况下修复它。

先分析再优化

猜测只会浪费时间。Zsh 包含一个内置的性能分析器,可以准确显示启动时间都花在了哪里。

将以下内容添加到 ~/.zshrc 的第一行:

zmodload zsh/zprof

将以下内容添加到最后一行:

zprof

打开一个新终端。你会看到类似这样的输出:

num  calls    time           self           name
1)   1        442.05  84.53%  254.54  48.68%  nvm_auto
2)   2        187.51  35.86%   91.66  17.53%  nvm
3)   1         75.70  14.48%   64.37  12.31%  nvm_ensure_version_installed

self 列显示的是每个函数自身花费的时间,不包括调用其他被分析函数的时间。优先处理数值最大的项目。

对于实际运行时间的测量,使用:

/usr/bin/time zsh -i -c exit

多次运行这个命令——第一次调用可能包含冷缓存的影响。

最常见的瓶颈

语言版本管理器(nvm、pyenv、conda)

这些是导致 zsh 启动缓慢的最大单一原因。仅默认的 nvm 初始化就可能增加 300-500ms。

解决方案:懒加载。 在实际调用这些工具之前不要初始化它们。

对于 nvm,用以下内容替换标准的初始化代码块:

export NVM_DIR="$HOME/.nvm"

nvm() {
  unfunction nvm
  [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
  nvm "$@"
}

使用包装函数而不是别名在这里更加健壮。基于别名的方法在 nvm 被间接调用时(例如,被脚本或其他函数调用)可能会失效,因为别名只在交互式的顶层命令位置展开。而函数在任何上下文中都表现得像真正的命令。

如果你使用 Oh-My-Zsh,启用带懒加载的 nvm 插件:

zstyle ':omz:plugins:nvm' lazy yes
plugins=(git nvm)

这种方法将某位用户的启动时间从 430ms 降低到 140ms——提升了 70%。

compinit 被多次调用

compinit 函数初始化 zsh 的补全系统。它的开销很大,而框架经常会意外地多次调用它。

最佳实践: 在所有 $fpath 修改完成后,只调用 compinit 一次。

# 首先添加到 fpath
fpath=($ZSH_CUSTOM/plugins/zsh-completions/src $fpath)

# 然后初始化补全
autoload -Uz compinit && compinit

如果你的 .zcompdump 文件过时或损坏,重新生成它:

rm -f ~/.zcompdump
compinit

使用 compinit -C 会跳过安全检查,速度更快,但在启用之前要理解其权衡:它不会在补全文件被篡改或属于其他用户时发出警告。

插件过多

每个插件在启动期间同步加载文件。无情地审查你的插件列表。

检查你实际使用的插件。github 和 brew 插件是出了名的慢。删除任何你不是每周都使用的插件。

重量级主题

查询 git 状态、检查网络资源或运行子进程的复杂主题会增加明显的延迟。

如果你使用 Powerlevel9k,切换到 Powerlevel10k。它是一个直接替代品,渲染提示符的速度快 10-100 倍。启用其 Instant Prompt 功能可获得近乎即时的启动体验。

Oh-My-Zsh 自动更新检查

Oh-My-Zsh 的更新检查在每次 shell 启动时运行,可能会占据启动时间的大部分。禁用它:

DISABLE_AUTO_UPDATE="true"

你仍然可以在需要时手动运行 omz update。

快速提升启动速度的方法

1. 减少插件数量 – 从配置中删除未使用的插件。
2. 懒加载版本管理器 – nvm、pyenv 和 conda 应该按需加载。
3. 只调用 compinit 一次 – 在所有 fpath 修改完成后。
4. 使用轻量级主题 – 或启用 Powerlevel10k 的 Instant Prompt。
5. 禁用自动更新 – 改为手动检查更新。

“快速”实际上是什么样的

一个优化良好的带 Oh-My-Zsh 的 zsh 配置应该在 150-300ms 内启动。不使用框架的话,50-100ms 是可以实现的。如果你的启动时间超过 500ms,说明有具体的问题——而 zprof 会告诉你是什么。

结论

不要盲目优化。分析你的启动过程,识别真正的瓶颈,并应用针对性的修复。大多数开发者可以通过懒加载一个版本管理器和删除几个未使用的插件,在不到十分钟内将 zsh 启动时间减少 50-80%。

记得在完成测量后从 .zshrc 中删除 zprof 相关的行。

常见问题

zsh 本身比 bash 慢吗?

不是。纯净的 zsh 安装启动速度与 bash 一样快,通常在 100 毫秒以内。感知到的缓慢几乎总是来自你的 .zshrc 在启动时加载的内容,比如插件、主题和版本管理器,而不是 shell 本身。

懒加载 nvm 会破坏我的 Node.js 工作流程吗?

实际上不会。懒加载意味着 nvm 及其管理的 Node 版本会在你第一次在会话中运行 nvm、node、npm 或 npx 时加载。在那次初始调用之后,一切都和之前完全一样工作。唯一的区别是 shell 启动更快了。

如何知道 compinit 是否被多次调用?

通过在 .zshrc 顶部添加 zmodload zsh/zprof 并在底部添加 zprof 来启用性能分析运行 zsh。在输出中,查看 compinit 或 compdump 旁边的多次调用。如果 calls 列显示的数字大于 1,说明你的配置正在冗余地初始化补全。

我应该用更轻量的框架替换 Oh-My-Zsh 吗?

不一定。Oh-My-Zsh 本身增加的开销适中。缓慢来自通过它加载的特定插件和主题。精简插件列表、懒加载版本管理器,并切换到像 Powerlevel10k 这样的快速主题,通常可以在不放弃框架的情况下将启动时间降到 300 毫秒以下。