VSCode 集成终端默认不加载你的 Shell 配置文件（比如 ~/.zshrc 或 ~/.bash_profile），所以 npm、python、conda 命令可能报“command not found”，或用的是系统旧版本——这不是 VSCode 坏了，是它启动方式本身就不读这些文件。
为什么 ~/.zshrc 里的 PATH 和 alias 在 VSCode 终端里不生效
VSCode 默认以**非登录、非交互式**方式启动 Shell（例如直接执行 zsh，而不是 zsh -i -l）。这意味着：
~/.zshrc 不会被读取（它只在交互式 Shell 中加载）~/.zprofile 才是 macOS GUI 应用（包括 VSCode）真正会读的初始化文件，但很多用户把环境变量全写在 ~/.zshrc 里Linux 桌面环境下，VSCode 可能继承桌面会话的环境变量，但不可靠，尤其重启后容易丢失
验证方法：在 VSCode 终端运行 sh -ic "echo $PATH"，再对比系统终端输出。如果不一样，说明环境没继承。
最稳的方案：用 terminal.integrated.profiles.* 启用登录 + 交互模式
这是目前唯一能完整复现 iTerm2 / Terminal.app 行为的方式，尤其适合依赖 nvm、pyenv、direnv 或 oh-my-zsh 的用户。
在 settings.json 中添加（macOS 示例）：{ "terminal.integrated.profiles.osx": { "zsh-login": { "path": "zsh", "args": ["-i", "-l"] } }, "terminal.integrated.defaultProfile.osx": "zsh-login"}-i 确保加载 ~/.zshrc，-l 触发登录流程（读 /etc/zprofile、~/.zprofile）Windows 上用 PowerShell Core（pwsh）时，改用："args": ["-NoExit", "-Command", ". $PROFILE"]不要写绝对路径如 /bin/zsh —— 用 "path": "zsh" 更健壮，它走 $PATH 查找
快速修复 PATH 但不想改 Shell 启动行为？用 terminal.integrated.env.*
适合只需要补几个命令路径、不依赖 Shell 插件或 alias 的场景。注意它只追加到现有 PATH 末尾，顺序错了照样找不到命令。
macOS 示例："terminal.integrated.env.osx": { "PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}"}${env:PATH} 是关键：必须显式引用原始值，否则会覆盖掉系统路径Windows 路径分隔符用 ;，反斜杠要双写或改用正斜杠："C:/Program Files/nodejs;${env:PATH}"该配置只影响集成终端，不影响调试器、任务（tasks.json 需单独设 options.env）
别踩这些坑
terminal.integrated.shellArgs.* 已弃用（VSCode 1.84+），强行加 ["-i", "-l"] 可能卡住终端或重复执行 ~/.zshrc；terminal.integrated.shell.* 也已废弃，必须用 profiles + defaultProfile；改完 settings.json 后必须**完全退出 VSCode 再重开**，热重载不刷新 profile 列表。
最常被忽略的一点：你改的其实是「新终端实例」的行为，已打开的终端标签页不会自动更新环境——关掉重开，或者新建一个。
评论(0)