VSCode终端找不到命令的根本原因是未加载shell配置文件（如~/.zshrc），导致PATH缺失；需设terminal.integrated.shellArgs为["-l"]并彻底重启VSCode，再新建终端验证。
VSCode终端里找不到命令，根本不是没装
你敲 node、python、brew 报 command not found，大概率不是软件没装，而是 VSCode 终端压根没加载你的 shell 配置文件（比如 ~/.zshrc 或 ~/.bash_profile）。图形界面启动的 VSCode 走的是 non-login shell 流程，跳过了这些初始化逻辑，PATH 就被砍掉一大截。
验证很简单：在 VSCode 终端里运行 echo $PATH，再打开系统原生终端（如 Terminal/iTerm）执行同一命令，对比缺了哪些路径——常见缺失项包括 /opt/homebrew/bin（Apple Silicon）、~/.pyenv/shims、%APPDATA%\npm（Windows）。
- macOS/Linux 最稳解法：在 VSCode 设置里搜
terminal.integrated.shellArgs，设为["-l"]（小写 L，不是数字 1），强制走 login shell - 改完必须关掉所有已打开的集成终端面板（不只是标签页），再按
Ctrl+`新建一个才生效 - 如果
~/.zshrc开头有[[ -n $ZSH_EVAL_CONTEXT ]] && return这类防护逻辑，它会提前退出，导致后续export PATH=...不执行；临时加一行echo "zshrc loaded"可验证是否真被读取
脚本有 x 权限还报 Permission denied？检查 shebang 和换行符
chmod +x script.sh 只是必要条件，不是充分条件。Linux/macOS 下执行 ./script.sh 时，内核会读首行 shebang 决定用哪个解释器。如果这行出错，系统就退回到用 /bin/sh 执行，而 /bin/sh 不支持 [[ ]]、source、$(( )) 等 Bash 特性，直接崩。
- 必须用
#!/usr/bin/env bash，不能写#!/bin/bash——后者在 macOS Catalina+、Alpine、某些 Docker 镜像里会报No such file or directory，因为 bash 实际在/usr/bin/bash - shebang 必须是文件第一行，前面不能有空格、BOM、注释；用
head -n1 script.sh | cat -A检查，看到^M或M-oM-?M-就是 BOM，看到#前有空格就说明不对 - Windows 编辑器保存的 CRLF 换行符（
\r\n）会导致 shebang 解析失败，用 VSCode 右下角换行符选择器切到LF，或终端里运行dos2unix script.sh
Code Runner 插件静默失败，其实是解释器配错了
点 Ctrl+Alt+N 没反应，或输出空行、报 line 5: [[: not found，基本可以断定 Code Runner 正在用 /bin/sh -c 执行你的 Bash 脚本。它默认不认 #!/usr/bin/env bash，也不管你有没有 chmod +x。
- 进设置搜
code-runner.executorMap，把shellscript对应值改成："bash -c 'cd $dir && bash $fileName'" - 别用
$fullFileName，它可能含空格或特殊字符；$fileName更安全 - 如果脚本依赖
~/.bashrc里的 alias 或函数，得显式source ~/.bashrc && $fileName，完整写法："bash -c 'cd $dir && source ~/.bashrc; bash $fileName'" - Windows 用户在 WSL 里可用；纯 PowerShell 环境下 .sh 文件无法执行，别硬试
tasks.json 比插件设置更可控，尤其适合团队协作
Code Runner 的配置只影响单人快捷键，而 tasks.json 定义的是项目级构建任务，能精确控制工作目录、环境变量、执行权限检查，还能和 Git 配合做 CI/CD。
- 在项目根目录建
.vscode/tasks.json，内容示例：
{
"version": "2.0.0",
"tasks": [
{
"label": "run-shell",
"type": "shell",
"command": "./${fileBasename}",
"group": "build",
"presentation": { "echo": true, "reveal": "always", "focus": false },
"options": {
"cwd": "${fileDirname}",
"env": { "PATH": "${env:PATH}:/usr/local/bin" }
}
}
]
}
command 用 ./${fileBasename} 表示当前文件，但前提是它已有执行权限；若不确定，可改用 bash ${file} 绕过权限检查options.env 是独立于终端的环境配置，不能复用 terminal.integrated.shellArgs 的效果，必须显式声明需要的 PATH 或其他变量真正麻烦的从来不是 chmod 或 shebang，而是你改了终端配置，却忘了 tasks.json 启动的是全新进程，环境完全隔离；或者你修好了本地 PATH，却没意识到远程服务器上的 .vscode-server 目录权限混乱，照样连不上。
