必须用.code-workspace文件才能创建可复用的工作区任务，因VSCode仅读取其所在目录下的.vscode/tasks.json，不扫描子目录；任务需显式设"type"为"shell"或"process"，通过"cwd":"${workspaceFolder:name}"指定执行目录，并用"args"数组传参，避免硬编码路径和平台兼容问题。
必须用 .code-workspace 文件才能创建可复用的工作区任务——其他方式（比如反复“添加文件夹”或拖拽进窗口）生成的任务只存于内存，关掉窗口就消失，也无法被团队成员复现。
为什么 tasks.json 放在项目子目录里不生效
VSCode 只读取工作区根目录（即 .code-workspace 文件所在目录）下的 .vscode/tasks.json，不会扫描 frontend/ 或 backend/ 子目录里的同名文件。
- 把
.vscode/tasks.json放在和my-team.code-workspace同级的目录下，不是放在某个子项目里 - 每个
task的"type"字段必须明确设为"shell"或"process"，不能依赖子项目自己的配置自动推断 - 若需在不同子项目中运行同名命令（如
npm run dev），要用"group": "build"+"presentation"控制终端复用行为，避免每次新开一个终端
怎么让一个 task 自动切换到对应子文件夹执行
关键靠 "cwd" 和 "args" 配合 ${workspaceFolder:name} 变量，否则默认在工作区根目录执行，极大概率报错“command not found”或找不到 package.json。
- 先在
.code-workspace的"folders"里给每个路径显式加"name"字段，例如{"name": "frontend", "path": "./frontend"} - 在
tasks.json中写"cwd": "${workspaceFolder:frontend}"，确保命令在正确目录下启动 - 不要用
${fileDirname}或${workspaceFolder}（后者指第一个文件夹，不可靠） - 如果任务需要传参（如
npm run build -- --env=staging），参数必须拆成数组写进"args"，不能塞进"command"
团队协作时 tasks.json 容易踩的坑
提交 .code-workspace 到 Git 是必须的，但 tasks.json 里藏着几个隐性风险点：
-
"windows"/"linux"/"osx"平台分支配置必须完整，漏掉任一平台会导致队友在对应系统上任务直接不可用 - 避免硬编码绝对路径（如
"C:\Users\xxx\node_modules\.bin\tsc"），统一用"command": "npm"+"args": ["run", "build"] - 如果任务依赖本地 CLI 工具（如
nx、pnpm），要在"dependsOn"或前置说明里注明安装要求，VSCode 不会自动帮你装 - 调试时发现任务输出乱码？检查
"presentation"下的"echo"和"reveal"是否设为true，否则终端可能静默执行完就关闭
真正麻烦的不是写对一个 task，而是当多个子项目共用同一套构建逻辑时，tasks.json 里一堆重复配置却没法抽离——VSCode 目前不支持跨文件引用或模板变量，只能靠手动同步或脚本生成。
