终端启动慢？29 倍提速的排查与修复全记录

系统环境：

问题描述

每次打开终端（iTerm2），需要等待约 1~2 秒，命令提示符才会出现，体验卡顿。

诊断过程

第一步：测量整体启动时间

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

结果：

2.33 real   2.20 user   0.53 sys

每次启动 zsh 交互式 Shell 耗时约 2.33 秒，属于明显异常。

第二步：查看 ~/.zshrc

逐行分析 ~/.zshrc 配置文件（共 203 行），锁定耗时操作。

第三步：逐项计时定位

# 单独计时每个 source 操作
{ time openclaw completion --shell zsh > /dev/null ; } 2>&1 | grep real
# → 1.56s ← 巨大！

根本原因分析

共发现 三个 耗时来源：

🥇 元凶 1：Conda 初始化（~1.5 秒）

原代码（第 172–185 行）：

__conda_setup="$('/Users/zhengqingwei/opt/miniconda3/bin/conda' 'shell.zsh' 'hook' 2> /dev/null)"
if [ $? -eq 0 ]; then
    eval "$__conda_setup"
...

问题：每次启动都要执行 conda 可执行文件（Python 程序），冷启动本身就要 1–1.5 秒。

🥈 元凶 2：OpenClaw 自动补全（~1.56 秒）

原代码（第 194 行）：

source <(openclaw completion --shell zsh)

问题：每次启动都动态运行 openclaw completion，该命令本身耗时 1.56 秒。

🥉 元凶 3：Spack 初始化（~0.3 秒）

原代码（第 196 行）：

source $SPACK_ROOT/share/spack/setup-env.sh

问题：Spack 的 setup 脚本遍历模块系统，有一定开销。

解决方案

修复 1：Conda 懒加载

思路：用同名 shell 函数占位，第一次真正使用 conda 时才初始化。

# >>> conda initialize (lazy load) >>>
conda() {
    unfunction conda
    local conda_sh="/Users/zhengqingwei/opt/miniconda3/etc/profile.d/conda.sh"
    if [ -f "$conda_sh" ]; then
        source "$conda_sh"
    else
        export PATH="/Users/zhengqingwei/opt/miniconda3/bin:$PATH"
    fi
    conda "$@"
}
# <<< conda initialize (lazy load) <<<

工作原理：unfunction conda 先删掉自身，再 source 真正的初始化脚本，最后执行原命令。之后 conda 就是真实命令了，后续调用不再有包装开销。

修复 2：OpenClaw 完成脚本缓存化

思路：提前生成一次补全脚本并保存为文件，之后直接读文件（0ms），只在 openclaw 版本更新时才重新生成。

# OpenClaw Completion (cached for fast startup)
_openclaw_cache=~/.zsh/completions/_openclaw
if [[ ! -f $_openclaw_cache || $(command -v openclaw) -nt $_openclaw_cache ]]; then
    mkdir -p ~/.zsh/completions
    openclaw completion --shell zsh >| $_openclaw_cache
fi
source $_openclaw_cache
unset _openclaw_cache

首次生成缓存的命令（仅运行一次）：

mkdir -p ~/.zsh/completions && openclaw completion --shell zsh > ~/.zsh/completions/_openclaw

修复 3：Spack 懒加载

export SPACK_ROOT=/opt/homebrew/opt/spack
spack() {
    unfunction spack
    source $SPACK_ROOT/share/spack/setup-env.sh
    spack "$@"
}

验证结果

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

总提速：29 倍

注意事项

1. (base) 不会自动出现：懒加载后，conda 不再自动激活 base 环境。如需自动激活：

   # 在 ~/.zshrc 末尾加（会增加约 0.3s）
   conda activate base

2. Spack 补全在懒加载前不可用：第一次执行 spack 命令后即可正常使用。

3. openclaw 缓存自动刷新：当 openclaw 二进制文件更新时（比 cache 新），下次开终端自动重新生成缓存（该次启动会稍慢，之后恢复正常）。

4. 如需恢复 conda 原始初始化：

   conda init zsh

文件修改摘要

修改文件：~/.zshrc