tasks.json必须严格置于项目根目录的.vscode/下，label需唯一无空格，type设为shell以继承环境变量，Windows路径分隔符统一，启用"echo":true和"panel":"dedicated"显示日志，isBackground:true配合problemMatcher支持热重载，端口冲突时优先用env注入PORT变量。
任务配置文件必须放在 .vscode/tasks.json 里
VSCode 的任务系统不会自动扫描项目根目录外的配置，tasks.json 必须严格放在项目根目录下的 .vscode/ 文件夹中。如果放错位置（比如丢在 src/ 下或漏掉 .vscode 这层），Ctrl+Shift+P → Tasks: Run Task 就找不到任何任务。
常见错误是手动新建文件但没建对路径，或者用快捷键生成时选错了工作区。建议直接右键项目根目录 → “Generate tasks.json from template” → 选 Others，再替换内容，避免路径出错。
-
label字段必须唯一且不含空格（推荐用start:dev而不是Start Dev Server），否则任务列表里会显示异常或无法触发 -
type设为shell（不是process）才能正确继承环境变量，尤其涉及npm或npx时 - Windows 用户注意：
command中的路径分隔符统一用/或\，别混用；cmd下npm run dev可能卡住，优先用shell类型 +terminal配置
presentation 里不加 echo 就看不到启动日志
Node 服务（如 Express、Vite、Next.js）启动后通常会输出类似 Listening on http://localhost:3000 的提示，但如果 tasks.json 里没配好 presentation，这些日志可能一闪而过，甚至被 VSCode 任务面板截断。
关键点在于：默认情况下，VSCode 任务面板只显示命令执行的退出状态，不实时转发 stdout。必须显式启用 echo 并设 panel 为 shared 或 dedicated：
"presentation": {
"echo": true,
"reveal": "always",
"panel": "dedicated",
"focus": false,
"clear": true
}
-
echo: true是必须项，否则连npm start执行了什么都看不见 -
panel: "dedicated"避免和其他任务日志混在一起；"shared"适合调试多个服务时对比输出 -
clear: true每次运行前清空旧日志，防止误读残留信息
热重载失败？检查 isBackground 和 problemMatcher
如果你用的是 nodemon 或 ts-node-dev，任务跑起来后改代码没反应，大概率是 VSCode 把它当成了“一次性命令”，启动完就认为任务结束了，于是终止了后台进程。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
解决方法是告诉 VSCode：“这玩意儿要一直跑着，别杀我”：
- 加
"isBackground": true—— 否则 VSCode 默认等待进程退出才释放终端 - 配一个轻量
problemMatcher，比如"$node"或自定义匹配启动成功的行："problemMatcher": { "owner": "node", "pattern": [ { "regexp": "^(.*?):(\d+):(\d+):\s+(error|warning|info)\s+(.*)$", "file": 1, "line": 2, "column": 3, "severity": 4, "message": 5 } ], "background": { "activeOnStart": true, "beginsPattern": "Starting development server", "endsPattern": "Compiled successfully" } } - Windows 上
nodemon可能因权限被杀，建议用npm run dev封装一层，而非直接调nodemon index.js
调试端口冲突时，别只看 package.json 里的 scripts
很多人把 tasks.json 里 command 写成 npm run dev，结果服务起不来，查半天发现是 package.json 里 "dev": "vite" 和本地已开的 Vite 实例端口冲突——但 VSCode 任务根本不会主动报端口占用错误，只会卡在 “Starting…”。
这时候得靠两步定位：
- 先在终端手动运行
npm run dev，看是否同样失败；如果失败，问题不在 VSCode 配置，而在脚本本身或环境 - 在
tasks.json的args里加端口参数，比如["--port", "3001"]，绕过默认端口竞争 - 更稳妥的做法：用
env注入变量，让脚本自己处理，例如"env": { "PORT": "3001" }，比硬编码args更灵活，也兼容不同框架（Express/Vite/Next 都认PORT）
真正麻烦的不是配置多，而是错误不报在任务面板里——它安静得像成功了一样。得习惯先手动验证脚本，再套进任务系统。
