VSCode项目启动时自动运行预设任务仅在通过.code-workspace文件打开时生效，直接“Open Folder”会忽略runOn:"folderOpen"；npm run dev类任务须配置isBackground:true和有效problemMatcher，并显式声明环境变量与完整命令路径。
VSCode 项目启动时自动运行预设任务，只在通过 .code-workspace 文件打开项目时生效；用「File → Open Folder」直接开文件夹，runOn: "folderOpen" 完全被忽略。
必须用 .code-workspace 才能触发 folderOpen
VSCode 的 runOn: "folderOpen" 是个“伪直觉”功能：它不响应普通文件夹打开行为，只认工作区文件。这是硬性限制，不是配置问题。
- 创建工作区：在 VSCode 中打开项目根目录 → 「File → Save Workspace As…」→ 保存为
my-app.code-workspace - 以后必须双击该文件，或命令行执行
code my-app.code-workspace，否则任务不会启动 - 如果项目已用文件夹方式打开，关掉后重新用
.code-workspace打开，否则旧会话不读新配置
npm run dev 类任务必须配 isBackground + problemMatcher
像 npm run dev、vite、nest start 这类长期运行的服务，VSCode 默认当成一次性命令处理——进程没退出，终端就卡在“正在运行”，后续操作（比如自动开浏览器）全失效。
-
"isBackground": true是强制项，缺了就会等进程退出，而它根本不会退 -
"problemMatcher"不能为空或缺失；推荐用自定义匹配器捕获启动成功信号，例如："problemMatcher": { "background": { "activeOnStart": true, "beginsPattern": "vite v", "endsPattern": "Local.*http" } } - Vite/NestJS 等启动快、日志少的框架容易被误判失败，可在
command前加sleep 1 &&，或用npx wait-on http://localhost:3000做健康检查
command 路径和环境变量必须手动对齐终端实际环境
VSCode 任务默认不加载你的 ~/.zshrc、不继承 $PATH、不识别 nvm 或 volta 管理的 Node 版本。你在终端能敲 pnpm，任务里写 "command": "pnpm" 很可能报 command not found。
- 可靠写法是把整条命令塞进
command字段："command": "pnpm run dev"（type: "shell"下允许） - 若用
type: "process"，必须写绝对路径："command": "/usr/local/bin/pnpm"，再配"args": ["run", "dev"] - 环境变量如
NODE_ENV必须显式传入："env": { "NODE_ENV": "development" } - Windows 用户注意：PowerShell 默认禁用脚本执行，需在
options.shell.executable显式指定"cmd.exe"
真正容易被忽略的是：即使所有配置都对，第一次打开 .code-workspace 时，VSCode 仍可能因缓存或权限延迟几秒才启动任务——别急着刷新或重试，看终端是否真没输出，而不是只看状态栏文字。
