VSCode 的 settings.json 不支持定义命令，仅能配置终端 profile；真正可执行的自定义命令需通过 tasks.json（推荐）或扩展实现。
如何在 settings.json 中定义终端命令并触发执行
VSCode 本身不支持直接在 settings.json 里“定义命令”，它只接受配置项；真正可执行的自定义命令必须通过扩展（extension）或任务（tasks.json）实现。但你可以用 terminal.integrated.profiles.* + terminal.integrated.defaultProfile.* 配合快捷键，模拟“一键运行某条终端命令”的效果。
常见误区是把 shell 脚本、alias 或 npm script 当成 VSCode 命令直接注册——这行不通。VSCode 的命令系统（commands）需要 JavaScript 实现，只能由扩展提供。
-
settings.json可配置终端 profile（如添加一个叫npm-start的终端启动项），但该 profile 只能运行 shell 启动命令（如bash -c "npm start"），不能带交互、不能传参、无法捕获退出码 - 若需参数化、条件判断、多步骤或错误处理，必须走
tasks.json：它支持args、group、problemMatcher，且可绑定快捷键（workbench.action.terminal.runActiveFile类似但不等价） - Windows 用户注意：PowerShell 默认会拦截脚本执行，
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser是绕过策略的前提，否则profile里调用.ps1会静默失败
用 terminal.integrated.profiles.* 快速绑定常用命令
这是最轻量的“伪命令”方案：让某个终端 Tab 启动时自动执行一条固定命令，适合开发服务器、本地调试服务这类长时运行任务。
在 settings.json 中添加：
"terminal.integrated.profiles.windows": {
"dev-server": {
"path": "pwsh.exe",
"args": ["-Command", "npm run dev"]
}
},
"terminal.integrated.defaultProfile.windows": "dev-server"
- Mac/Linux 把
profiles.windows换成profiles.osx或profiles.linux，path改为"zsh"或"bash" -
args是数组，不是字符串；写成"args": ["npm run dev"]会导致整个字符串被当做一个参数传给 shell，失败概率高 - 该配置仅影响新打开的终端，已存在的终端不会重载；想快速触发，可用快捷键
Ctrl+Shift+`（再按一次选 profile）或右键终端标签页 → “Select Default Profile”
用 tasks.json 实现真正可控的命令执行
当你需要“运行后自动显示输出”“失败时标红”“完成后弹窗提示”，就必须用任务。它本质是 VSCode 的构建/运行抽象层，比终端 profile 更可靠。
在工作区根目录建 .vscode/tasks.json：
{
"version": "2.0.0",
"tasks": [
{
"label": "build:prod",
"type": "shell",
"command": "npm run build",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true
}
}
]
}
-
label就是命令名，可在命令面板（Ctrl+Shift+P）搜到，也可绑定快捷键：{ "key": "ctrl+b", "command": "workbench.action.terminal.sendSequence", "args": { "text": "npm run build\u000D" } }是错的；正确绑定是"command": "workbench.action.terminal.runSelectedTask"+ 指定args -
type: "shell"表示跨平台执行；type: "process"则跳过 shell 解析，适合调用二进制（如node），但无法用&&连写命令 - 如果命令依赖当前文件路径（比如对当前
.ts文件执行 lint），要用${file}变量；但注意：变量只在command和args中生效，不在shell字符串里展开
为什么不要用 keybindings 直接 sendSequence 执行命令
有人尝试在 keybindings.json 里用 workbench.action.terminal.sendSequence 发送命令，看似简单，实则隐患多。
- 终端可能未就绪：快捷键触发时，终端还没启动或正在执行前一条命令，
sendSequence会把文本塞进输入流，导致拼接错误（如上一条命令还没回车，新命令就贴上去） - 无法判断执行结果：你不知道命令是否成功、是否卡住、是否需要输入；而
tasks.json的isBackground+problemMatcher可监听输出模式 - 路径上下文丢失：终端默认工作目录是上次打开的位置，不是当前文件所在目录；
tasks.json默认使用${fileDirname}，更可控 - 调试困难：sendSequence 不生成任务历史，无法在“任务”面板中查看、重试、停止；出问题只能翻终端滚动条
真正要定制命令逻辑，最终都得回到扩展开发——用 vscode.commands.registerCommand 写 TypeScript，再通过 vscode.terminal.createTerminal 控制输入输出。但对 95% 的日常需求，tasks.json 已足够稳。别为了省两行配置，把执行链路搞成不可观测的黑盒。
