VSCode中运行任务必须用tasks.json而非launch.json，因后者专为调试设计，会阻塞进程并监听端口；tasks.json则用于纯执行如构建、启动服务等，需显式配置command、cwd、env等字段才能正确加载环境变量和路径。
能直接在 VSCode 里按 Ctrl+Shift+P 运行 npm start 或 node index.js 而不手动切终端，才算真正配好了运行任务——不是靠插件“点一下就跑”，而是让 VSCode 知道该用什么命令、在哪执行、带哪些环境。
为什么 launch.json 不能代替运行任务？
launch.json 是为调试服务的，它启动的是带 inspector 的 Node 进程，会阻塞、挂起、监听端口；而“运行任务”是纯执行，比如构建、打包、启动 dev server，不打断点、不卡住、输出直接可见。两者目的不同，混用容易导致：脚本重复执行、process.exit() 行为异常、环境变量丢失（尤其 .env）、甚至 nodemon 启动失败。
- 调试用
launch.json，运行用tasks.json -
launch.json中的"program"指向单个 JS 文件，tasks.json的"command"可以是任意 shell 命令（npm、node、ts-node） - VSCode 内置终端默认不加载
.env，但任务可以显式注入："env": { "NODE_ENV": "development" }
如何配置 tasks.json 实现 npm script 自动识别？
VSCode 能自动读取 package.json 里的 "scripts"，但前提是项目根目录下有合法的 package.json，且文件未被格式错误或 BOM 头污染。
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 确保
package.json有至少一个有效 script，例如："start": "node index.js" - 按
Ctrl+Shift+P→ 输入Tasks: Configure Task→ 选Create tasks.json from template→ 选npm - 生成的
.vscode/tasks.json会包含"type": "shell"和"script": "start"字段，VSCode 就能识别并列出所有 script - 若
npm run build报错command not found，检查tasks.json中是否漏了"group": "build"—— 缺这个会导致 VSCode 不把它归类为构建任务，无法绑定Ctrl+Shift+B
运行任务中怎么正确加载 .env 文件？
VSCode 任务默认不读 .env，dotenv 也不能自动生效，必须手动注入或调用解释器加载。
- 最简方式：在
tasks.json的"args"中加-r dotenv/config，例如：["-r", "dotenv/config", "index.js", "dotenv_config_path=.env"] - 更稳妥做法：用
"shell"类型任务调用npm run dev，并在package.json的 script 中写完整命令："dev": "node -r dotenv/config index.js dotenv_config_path=.env" - Windows 用户注意：
.env文件编码必须是 UTF-8 无 BOM，否则dotenv会静默失败，process.env为空 - 别把
.env写进tasks.json的"env"字段里——那只是静态键值对，不会解析文件内容
code-runner 插件跑 Node 脚本时为何总缺环境变量？
code-runner 本质是执行 node $fullPath，绕过了 npm 生命周期和 package.json 配置，所以不走 scripts、不加载 .env、也不识别 "type": "module"。
- 如果非要用
code-runner，必须改它的执行命令：打开设置 → 搜索code-runner.executorMap→ 找到javascript项 → 替换为："node -r dotenv/config $fileName dotenv_config_path=$workspaceRoot/.env" - 但更推荐停用
code-runner，改用原生tasks.json+npm script组合——可控、可复现、与 CI/CD 一致 - 尤其当脚本依赖
exports字段（如"exports": { ".": "./dist/index.js" }）时，code-runner直接报Cannot find module，因为没走 Node 的 package resolution 流程
真正难的不是写几行 JSON，而是让每个任务都清楚自己该在什么上下文里执行——路径、环境、模块系统、入口逻辑，缺一不可。很多人配完发现 npm run dev 在终端能跑，VSCode 里却报错，问题往往出在 tasks.json 没指定 "cwd"（当前工作目录），默认用了文件所在目录，而不是项目根目录。
