VSCode报“command not found”主因是终端未加载shell配置导致PATH缺失；macOS/Linux需设terminal.integrated.shellArgs为["-l"]启用登录shell，Windows应手动补PATH或从终端执行code启动。
VSCode报错 command not found，90%不是命令没装，而是终端压根没拿到你 shell 里配置好的 PATH —— 它启动的是一个“裸壳”，不读 ~/.zshrc、~/.bash_profile 或 Windows 用户环境变量。
为什么 VSCode 终端看不见 node/python/conda
macOS/Linux 默认以非登录 shell 启动集成终端，跳过所有初始化文件；Windows 图形界面启动的 VSCode 根本继承不到用户级环境变量。结果就是：node、python3、conda、nvm 这些你明明装好且在 iTerm/CMD 里能用的命令，在 VSCode 里全报 command not found。
- 验证方法：在 VSCode 终端运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），复制输出，再跟系统原生终端对比 —— 缺失/opt/homebrew/bin、$HOME/.nvm/versions/node/v18.18.2/bin、%APPDATA% pm就是它了 - 常见漏掉的路径还包括：
~/.local/bin（pip user install）、C:Program FilesGitin（Windows Git）、D:Anaconda3Scripts（conda） - 别信“我改了 .zshrc 就行”——如果 VSCode 没加载它，改了也白改
macOS/Linux 必须启用 login shell
默认不读 ~/.zshrc，得强制走登录流程。不是加 -i（交互式），而是加 -l（小写 L）。
- 打开 VSCode 设置（Cmd+,），搜
terminal.integrated.shellArgs - 设为：
"terminal.integrated.shellArgs.osx": ["-l"]（macOS）或"terminal.integrated.shellArgs.linux": ["--login"]（Linux） - 关掉所有已打开的集成终端，新建一个 —— 此时
echo $PATH应该和 iTerm 一致了 - 如果仍不生效，检查
~/.zshrc开头有没有[[ -n $ZSH_EVAL_CONTEXT ]] && return这类提前退出逻辑；可临时加一行echo "zshrc loaded"验证是否真被读取
Windows 用户绕过 GUI 环境限制
图形界面双击启动的 VSCode 拿不到用户 PATH，有三个实操性强的解法：
-
推荐首选：彻底退出 VSCode（macOS 右键 Dock → Quit；Windows 任务管理器结束所有
Code.exe），然后在 CMD/PowerShell 里运行code启动 —— 前提是你已执行过 Shell Command: Install 'code' command in PATH - 在 VSCode 设置中搜
terminal.integrated.env.windows，手动补全 PATH：{"PATH": "${env:PATH};C:\Users\XXX\AppData\Roaming\npm;C:\Program Files\Git\bin"}（注意双反斜杠） - 若用 PowerShell 且报
The term 'conda' is not recognized，说明$PROFILE没加载；可在设置中把terminal.integrated.defaultProfile.windows改为"Command Prompt"临时绕过
conda activate 报错不是 PATH 问题，是 shell 初始化缺失
CommandNotFoundError: Your shell has not been properly configured to use 'conda activate' 这类错误，本质是 conda 没在当前 shell 类型下初始化，和 PATH 是否完整无关。
- 先确认终端类型：VSCode 命令面板（Ctrl+Shift+P）输入
Terminal: Select Default Profile，看当前用的是 PowerShell、CMD 还是 Git Bash - 对应执行：
conda init powershell（PowerShell）、conda init cmd.exe（CMD）、conda init bash（Git Bash） - 执行后必须重启 VSCode —— 不是重启终端，是整个进程
- 如果之前切过终端类型又切回来，VSCode 可能缓存了旧配置；可先切到 CMD，再切回 PowerShell，再重启，往往比单次
conda init更可靠
最易被忽略的一点：VSCode 的 Python 扩展选了解释器，不会自动同步到终端；python --version 显示的永远是 shell 自己找的版本，不是你项目里配的那个 —— 想用 venv，还得手动 source .venv/bin/activate 或 .venvScriptsActivate.ps1。
