VSCode集成终端默认以非登录shell启动，不加载~/.zshrc，导致Oh My Zsh主题、插件和别名失效；需在settings.json中为对应系统配置terminal.integrated.profiles.*并设置args: ["-l"]启用登录shell，同时确保已安装Nerd Font并正确配置terminal.integrated.fontFamily。
VSCode集成终端默认不加载~/.zshrc，所以即使服务器或本地已装好zsh和oh-my-zsh，终端里也看不到主题、插件、别名——这不是安装失败，是启动模式错了。
为什么echo $SHELL显示zsh但主题不生效
VSCode终端默认以「非登录 shell」方式调用zsh，而~/.zshrc只在登录或交互式 shell 中被自动读取。常见表现：echo $ZSH_THEME为空、which git正常但git别名不工作、Powerlevel10k提示符显示为纯文本%。
验证是否加载成功：在~/.zshrc末尾加一行echo "zshrc loaded"，重启终端看是否输出；没输出就说明根本没执行。
-
zsh -l（带-l参数）会强制作为登录 shell 启动，触发~/.zshrc加载 -
zsh -i -c "source ~/.zshrc && exec zsh"是更稳妥的 fallback 方式，尤其在 WSL 或自编译 zsh 下 - 不要只改
terminal.integrated.defaultProfile.*，必须配合profiles配置指定args，否则defaultProfile只是选了可执行路径，没控制启动参数
terminal.integrated.profiles怎么写才不踩坑
macOS 和 Linux 的路径、参数略有差异，直接复制易出错。关键不是“设成 zsh”，而是“让 zsh 正确加载你的配置”。
Linux 示例（Ubuntu/Debian）：
"terminal.integrated.profiles.linux": {
"zsh": {
"path": "/usr/bin/zsh",
"args": ["-l"]
}
}
macOS 示例（Catalina+）：
"terminal.integrated.profiles.osx": {
"zsh": {
"path": "/bin/zsh",
"args": ["-l"]
}
}
- 路径必须真实存在：
which zsh结果要和path一致，常见错误是写成/usr/bin/zsh但实际是/bin/zsh - 改完配置后，必须关闭所有终端页签再新建一个，
Reload Window无效 - 如果用了
ZSH_CUSTOM，确保${ZSH_CUSTOM}/plugins/下有对应插件目录，否则plugins=(zsh-syntax-highlighting)会静默失败
zsh-autosuggestions和zsh-syntax-highlighting为什么总报错
这两个插件不是装完就能用，它们对加载顺序和初始化时机敏感，常见报错如command not found: compinit或输入时卡顿、高亮失效。
-
zsh-autosuggestions必须放在plugins=()里靠前位置（例如第二位），它依赖compinit但不能在compinit之前被加载 -
zsh-syntax-highlighting必须放在plugins=()最后一位，它需要等其他插件解析完命令结构后再做渲染 - 两者都需手动克隆到
$ZSH_CUSTOM/plugins/，仅写进plugins=()列表不会自动下载 - 若终端启动慢，删掉
plugins里不用的项（比如rails、ruby），4 个以内最稳
Powerlevel10k主题显示乱码或空白怎么办
这不是 Zsh 配置问题，是字体链路断了。Powerlevel10k 依赖 Nerd Font 提供的图标（如分支符号、状态箭头⇡），VSCode 默认字体不支持这些 Unicode 字符。
- 必须下载并安装 Nerd Font（推荐
JetBrainsMono Nerd Font或MesloLGS NF） - VSCode 设置中搜索
terminal.integrated.fontFamily，填入"JetBrainsMono Nerd Font", "monospace"（注意引号和逗号） - 不要只改
fontFamily，还要确认系统字体缓存已刷新（macOS 执行sudo atsutil databases -remove，Linux 一般无需操作） - 如果仍乱码，检查
locale：运行locale，确保LANG=en_US.UTF-8；若不是，在~/.zshrc开头加export LANG=en_US.UTF-8
最容易被忽略的是：VSCode 终端和你本地 Terminal.app 或 iTerm2 是两套独立环境，~/.zshrc改了，必须重启 VSCode 终端才能生效；而字体配置一旦漏掉 Nerd Font 安装这步，再怎么调zshrc都没用。
