vscode 的“运行”按钮（ctrl+f5）需通过 tasks.json 定义 shell 类型任务并设为 isdefault: true 才能执行自定义 shell 脚本；脚本须有执行权限（chmod +x）、正确 shebang（#!/usr/bin/env bash），且 tasks.json 中 command 必须是相对或绝对路径，不能写在 launch.json 里。
VSCode 里怎么让运行按钮执行自定义 Shell 脚本
VSCode 的“运行”按钮（即 Run 按钮或 Ctrl+F5）默认不支持直接绑定 Shell 脚本，它依赖于调试器或任务系统。想点一下就跑 ./deploy.sh 或 npm run dev，必须通过 tasks.json 定义一个可触发的任务，并把它设为“启动任务”或绑定到运行命令。
关键不是写个脚本，而是让 VSCode 认出这个脚本是“可运行的入口”。常见错误是把脚本路径写死在 launch.json 里——那根本不会执行，因为 launch.json 是给调试器用的，不是用来跑任意命令的。
- 所有 Shell 脚本必须有可执行权限：
chmod +x ./script.sh - 脚本第一行推荐写
#!/usr/bin/env bash，避免因/bin/bash路径差异导致执行失败 - VSCode 默认工作目录是打开的文件夹根目录，脚本里的相对路径（如
./src/）要基于该路径计算 - 如果脚本依赖环境变量（如
NODE_ENV），需在tasks.json中显式设置env字段，VSCode 不自动继承终端环境
tasks.json 中配置可被运行按钮调用的任务
VSCode 的“运行”按钮实际会尝试执行当前工作区中配置的“启动任务”（isDefault: true 且 type: "shell" 的任务）。必须把你的 Shell 脚本包装成一个 shell 类型任务，并标记为默认。
示例：在 .vscode/tasks.json 中写：
{
"version": "2.0.0",
"tasks": [
{
"label": "run:dev-server",
"type": "shell",
"command": "./scripts/start-dev.sh",
"group": "build",
"isDefault": true,
"presentation": {
"echo": true,
"reveal": "always",
"panel": "shared",
"clear": true
},
"problemMatcher": []
}
]
}
-
"type": "shell"是必须的，"shell"类型才能正确解析./xxx.sh；"process"类型会忽略 shebang，容易报Permission denied -
"isDefault": true才能让Ctrl+F5或命令面板里的Tasks: Run Task→Run Build Task直接命中它 -
"presentation": { "panel": "shared" }很重要：否则每次运行都会新开一个终端面板，旧输出被丢弃，不方便观察日志滚动 -
problemMatcher留空或设为[]，除非脚本输出符合某种错误格式（比如 webpack 的错误），否则加了反而干扰识别
为什么 launch.json 里加 shell 命令没反应
很多人试图在 launch.json 的 preLaunchTask 或 postLaunchTask 里直接写 "command": "./deploy.sh"，这是无效的。VSCode 的 launch.json 只接受已注册的任务名（label），不接受内联命令。
-
preLaunchTask字段值必须是tasks.json中某个label字符串，比如"run:dev-server"，不能是路径或命令行 - 如果任务未出现在
tasks.json中，VSCode 启动调试时会报错：Could not find task 'xxx' - 即使你只想要“运行脚本”，也不该绕过
tasks.json——它是唯一被Run按钮和调试器共同认可的调度入口 - 注意大小写和空格：
"label": "run:dev"和"preLaunchTask": "run:dev "（末尾空格）会导致匹配失败，错误信息里不会提示空格问题
跨平台脚本在 Windows 上执行失败怎么办
Shell 脚本在 Windows 的 VSCode（即使开了 WSL）里可能因终端类型不一致而失败。VSCode 默认使用 PowerShell 或 CMD，它们不认识 #!/bin/bash，也不支持 source 或 [[ 语法。
- 最稳方案：在
tasks.json中强制指定终端 shell，加"options": { "shell": { "executable": "/bin/bash", "args": ["-c"] } }（仅限 WSL/Linux/macOS） - Windows 用户若用 Git Bash，可设
"executable": "C:\Program Files\Git\bin\bash.exe"，但路径含空格时需转义或用短路径 - 更兼容的做法是把逻辑迁移到
package.json的scripts字段，然后在tasks.json中调用npm run xxx——npm 会自动选择合适 shell - 不要依赖
$HOME或~：Windows 下~展开失败，改用${env:USERPROFILE}或${workspaceFolder}
真正卡住的地方往往不是脚本本身，而是 VSCode 没搞清“该用哪个程序去跑它”，以及“在哪儿跑”。任务配置里少一个 type 或漏掉 isDefault，运行按钮就只是个摆设。
