VS Code通过配置终端、任务和调试器调用外部命令行工具，关键在于确保工具全局可执行、环境路径正确、上下文匹配。
VS Code 本身不“集成”命令行工具，而是通过配置终端、任务和调试器来调用外部命令行工具——关键在于让工具在正确环境、正确路径、正确上下文中运行。
确认命令行工具已全局可执行
VS Code 的集成终端（Ctrl+`）默认继承系统 PATH，但仅当工具安装后已加入环境变量且能被 which（macOS/Linux）或 where（Windows）识别才算真正就绪。
- 在系统终端中运行
node -v、python --version或你的工具名（如rustc --version），确保有输出 - 如果提示
command not found，不要试图在 VS Code 里“绕过”，先修复 shell 配置（如~/.zshrc或PATH环境变量）并重启 VS Code - Windows 用户注意：Git Bash、WSL、PowerShell 的 PATH 不互通；VS Code 默认启动的是当前系统的默认 shell，不是你日常用的那个
用 tasks.json 运行带参数的命令行工具
适合需要复用、带输入/输出、需捕获错误码的场景（如构建、格式化、自定义 lint）。
- 项目根目录建
.vscode/tasks.json，内容模板如下：
{
"version": "2.0.0",
"tasks": [
{
"label": "run-my-cli",
"type": "shell",
"command": "my-tool",
"args": ["--input", "${fileBasename}", "--output", "dist/"],
"group": "build",
"problemMatcher": []
}
]
}
-
"type": "shell"表示走系统 shell（支持管道、重定向）；用"process"则跳过 shell，更轻量但不支持|或&& -
${fileBasename}是常用变量，完整列表见 VS Code 官方文档 “Variables reference” - 若工具依赖项目级配置（如
.eslintrc.cjs），确保它位于工作区根目录，或用"cwd": "${workspaceFolder}"显式指定工作目录
让快捷键直接触发命令行工具
不用打开终端、不用输命令，按一下就跑——适合高频操作（如保存时格式化、一键部署）。
- 打开命令面板（
Ctrl+Shift+P），搜 “Preferences: Open Keyboard Shortcuts (JSON)” - 添加自定义快捷键条目：
[
{
"key": "ctrl+alt+f",
"command": "workbench.action.terminal.runActiveFile",
"when": "terminalFocus"
},
{
"key": "ctrl+alt+b",
"command": "workbench.action.terminal.sendSequence",
"args": { "text": "npm run build\u000D" },
"when": "terminalFocus"
}
]
-
\u000D是回车符，必须带上，否则只输入不执行 - 若想在任意焦点下触发（比如编辑器里按快捷键就发命令），去掉
"when"或改成"editorTextFocus"，但注意安全风险：误触可能执行危险命令 - 更稳妥的方式是绑定到
tasks.json中的 task，用"command": "workbench.action.terminal.runSelectedTask"
调试器里调用命令行工具？通常不该这么做
VS Code 的 launch.json 是为调试进程设计的，不是为运行 CLI 工具。强行塞进去容易导致：
- 调试会话卡住（工具没 stdin/stdout 句柄）
- 断点失效（CLI 工具本身不是被调试目标）
- 无法看到实时输出（除非显式配置
"console": "integratedTerminal"）
真正需要“调试 CLI”的场景，应该用该语言对应的调试器（如 Python 的 debugpy、Node.js 的 inspector），而不是把 my-cli --help 当成一个要 debug 的程序。
复杂点往往藏在环境隔离上：比如你在 nvm 管理的 Node 版本下装了 prettier，但 VS Code 终端启动时没加载 nvm，就会找不到命令——这种问题比配置本身更难排查。
