VSCode外部工具需通过tasks.json配置任务而非插件，因任务默认不加载shell配置导致“command not found”，应使用terminal类型任务或显式路径；右键菜单需插件支持，args与command须分离，变量替换仅在二者中生效。
VSCode 本身不内置“外部工具”菜单，所谓配置外部工具，本质是通过 tasks.json 定义可执行命令，并绑定到快捷键、右键菜单或终端任务运行器中——不是装个插件点几下就能用，得写配置、理路径、处理 Shell 环境差异。
为什么直接在终端里运行的命令，在 VSCode 任务里会报 “command not found”
VSCode 的集成终端（Integrated Terminal）通常继承系统 shell 环境（如 zsh 或 PowerShell），但 tasks.json 启动的任务默认不加载 shell 配置文件（~/.zshrc、~/.bash_profile 等），导致 PATH 缺失，python、prettier、rustfmt 等命令找不到。
- 临时解决：在
tasks.json中显式指定完整路径，比如/opt/homebrew/bin/prettier而非仅prettier - 长期方案：启用
terminal类型任务，让其复用终端环境：{ "version": "2.0.0", "tasks": [ { "label": "format with prettier", "type": "shell", "command": "prettier --write ${file}", "presentation": { "echo": true, "reveal": "never", "focus": false, "panel": "shared", "showReuseMessage": true, "clear": false } } ] } -
macOS 用户尤其注意：GUI 应用（包括 VSCode）启动时不会读取
~/.zshrc，除非你通过code命令从终端启动 VSCode
如何把自定义脚本变成右键菜单项（比如“用 Python 运行当前文件”）
VSCode 没有原生右键注册机制，需靠 tasks.json + keybindings.json + 可选插件（如 Code Runner）协同实现。最轻量可控的方式是定义 task 并绑定快捷键，再配合扩展 Command Palette: Run Task 手动触发；若坚持要右键，推荐使用 Run on Save 或 Custom CSS and JS Loader 类插件——但后者有安全风险且易被更新破坏。
- 在
.vscode/tasks.json中添加一个带group的 task："group": "build", "presentation": { "panel": "new" } - 在
keybindings.json中绑定快捷键：[{ "key": "ctrl+alt+r", "command": "workbench.action.terminal.runActiveFile" }]（注意：这是运行当前文件的内置命令，非自定义；如需真正自定义，必须用tasks.json的label值匹配command字段） - 右键菜单需依赖扩展：例如安装
Shell Command插件后，可在settings.json中配置："shell-command.customCommands": [{ "command": "python3 ${file}", "name": "Run Python File" }]
tasks.json 中 args 和 command 的常见陷阱
command 是可执行文件路径或命令名，args 是传给它的参数列表；二者不能混用，也不能写成字符串拼接形式。VSCode 会把 args 作为独立数组元素传递给子进程，空格不会自动拆分。
- 错误写法：
"command": "prettier --write ${file}"（把参数塞进 command 字符串，会导致整个字符串被当做一个命令名） - 正确写法：
"command": "prettier", "args": ["--write", "${file}"] - 变量替换只在
args和command字段生效，不在env或注释中生效 - Windows 下注意路径分隔符和引号：
${fileBasenameNoExtension}比${file}更安全，避免空格或括号引发解析失败
真正卡住人的往往不是语法，而是环境变量隔离、跨平台路径处理、以及 VSCode 启动方式带来的 shell 初始化差异——建议先在终端里手动跑通命令，再照搬进 tasks.json，并始终用 echo $PATH 对比终端与 task 的实际环境。
