VSCode不支持打开文件夹时自动运行npm脚本，仅通过.code-workspace打开且配置tasks.json中"runOn":"folderOpen"、"isBackground":true及有效problemMatcher才生效。
VSCode 本身不支持“一打开文件夹就自动跑 npm run dev”这种直觉式行为，必须用 tasks.json 配合工作区（.code-workspace）才能触发自动运行，普通文件夹打开方式完全无效。
必须用 .code-workspace 打开，否则 runOn: folderOpen 不生效
VSCode 只在通过 .code-workspace 文件打开项目时才识别 "runOn": "folderOpen"。直接用「File → Open Folder」打开单个文件夹，这个字段会被忽略，任务根本不会启动。
- 创建工作区：在 VSCode 中打开项目目录 → 「File → Save Workspace As…」→ 保存为
my-project.code-workspace - 以后都双击这个文件，或命令行执行
code my-project.code-workspace - 确保
tasks.json放在项目根目录下的.vscode/文件夹里，路径必须是.vscode/tasks.json
npm run dev 类任务必须设 isBackground: true + problemMatcher
像 npm run dev 这种长期运行的服务，如果不明确声明后台模式，VSCode 会当成一次性命令执行完立刻关闭终端，你甚至看不到日志。
-
"isBackground": true是强制要求，缺一不可 -
"problemMatcher"不能为空数组（[]）或缺失；推荐用内置匹配器如"$tsc-watch"，或自定义匹配启动成功的日志行，例如："problemMatcher": { "pattern": [], "background": { "activeOnStart": true, "beginsPattern": "Local", "endsPattern": "started" } } - Vite/NestJS 等启动快、日志少的框架容易被误判失败，可在
command前加sleep 1 &&，或用npx wait-on http://localhost:3000做健康检查
command 路径和 shell 行为必须手动对齐终端实际环境
VSCode 任务默认不读你的 ~/.zshrc 或 $PATH，你在终端能直接敲 pnpm，任务里写 "command": "pnpm" 很可能报错「not found」。
- 推荐用
"type": "shell"，然后把整条命令写进command字段，例如："command": "pnpm run dev" - 如果坚持用
"type": "process"，就得写绝对路径："command": "/usr/local/bin/pnpm"，再配"args": ["run", "dev"] - Windows 用户注意：PowerShell 默认禁用脚本执行，要么改策略，要么在
options.shell.executable显式指定cmd.exe
别指望 tasks.json 自动继承 NODE_ENV 等环境变量
任务启动后，NODE_ENV、GOOS 这类变量默认为空，不会从你的 shell 继承。要让服务按预期环境启动，必须显式传入。
- 在任务里加
"options": {"env": {"NODE_ENV": "development"}} - 路径含空格？
args必须拆成独立字符串项，比如["--outDir", "dist/output with space"]，不能写成["--outDir dist/output with space"] -
label重复会导致任务覆盖——两个任务都叫start，快捷键只能调出一个，但dependsOn仍可能悄悄执行另一个
最常被忽略的其实是工作区打开方式和环境变量隔离这两点：很多人反复调 tasks.json 却始终没效果，问题不在配置本身，而在于一直用「Open Folder」而不是 .code-workspace，或者以为任务会自动加载 shell 的所有配置。
