code命令需同时满足三条件才可用：命令可执行、终端继承正确PATH、任务运行在正确上下文；macOS/Linux需检查shell配置文件并source，Windows用where code验证，WSL需手动软链，tasks.json中type选shell支持变量扩展而process不支持。
VSCode 里命令行工具不是“装上就能用”，而是必须让 code 命令可执行、终端能继承正确的 PATH、任务能跑在对的上下文里——三者缺一不可。
确认 code 命令已真正加入系统 PATH
很多人点过菜单里的 “Install 'code' command in PATH”，但关掉终端重开后仍报 command not found。这不是 VSCode 的问题，是 shell 没加载新路径。
- macOS/Linux：检查
~/.zshrc或~/.bash_profile是否包含类似export PATH="/usr/local/bin:$PATH"的语句；没加就补上，然后运行source ~/.zshrc - Windows：打开新 PowerShell 或 CMD，运行
where code（不是which），确认输出路径存在且可访问 - 验证方式统一：在系统终端（非 VSCode 内置终端）里直接输
code --version，有输出才算真正就位
终端默认 shell 不等于你日常用的那个
VSCode 启动集成终端时，调用的是系统“默认 shell”，而不是你每天在 iTerm 或 Windows Terminal 里手动选的那个。PowerShell、Git Bash、WSL、CMD 彼此隔离，PATH 互不共享。
- 按
Ctrl + `打开终端，右下角会显示当前 profile 名（如 “Git Bash” 或 “PowerShell”），点击可切换 - 想永久设为 Git Bash？在设置里搜
terminal.integrated.defaultProfile.windows，值设为"Git Bash" - 如果用 WSL，别只装 Git Bash 就完事——
code命令默认不进 WSL 的 PATH，得手动把 Windows 下的code路径软链过去，或改用code-insiders的 WSL 版本
tasks.json 中 type: "shell" 和 type: "process" 差在哪
写任务时选错类型，会导致管道、变量扩展、环境变量失效，尤其在跨平台脚本中容易静默失败。
-
type: "shell"：走完整 shell 解析，支持|、&&、$HOME、${fileBasename}等，适合带逻辑的命令（如npm run build && cp dist/* ../server/public/） -
type: "process"：跳过 shell，直接spawn进程，启动快、无 shell 开销，但不支持重定向和变量，适合纯二进制调用（如eslint、prettier单文件格式化） - 常见坑：
args是字符串数组，不能写成"args": ["--fix src/*.ts"]—— glob 不会被 shell 展开，得改成"args": ["--fix", "src/**/*.ts"]并依赖工具自身支持
快捷键触发任务时，工作目录容易错位
用 Ctrl+Shift+P → Tasks: Run Task 能看到所有任务，但绑定快捷键后，${workspaceFolder} 可能指向多根工作区里的第一个文件夹，而非你当前编辑的文件所在位置。
- 显式指定
"cwd": "${fileDirname}"，确保任务总在当前文件目录下运行（比如你想对单个.py文件跑black） - 若任务依赖项目级配置（如
.prettierrc），而该文件不在工作区根目录，就得用"cwd": "${workspaceFolder}/packages/foo"锁死路径 - 快捷键本身不感知编辑器焦点——哪怕你在子目录的文件里按了键，任务仍按
tasks.json里定义的cwd执行，不会自动“跳进去”
最常被忽略的一点：VSCode 的终端和任务都依赖 shell 初始化逻辑，而 shell 初始化脚本（如 ~/.zshrc）里如果有交互式判断（如 [ -t 0 ]）、阻塞型命令（如 sleep 1）或未加 export 的变量，会导致 VSCode 终端卡住或环境变量缺失——这类问题不会报错，只会让你的 node 找不到、rustc 版本旧、甚至 git 提交失败。
