VSCode测试任务配置必须严格遵循规范：tasks.json须置于项目根目录下.vscode文件夹中，version字段必须为"2.0.0"；command需写全路径或用shell类型并继承环境变量；presentation需设"reveal":"always"确保终端可见；group:"test"启用Ctrl+Shift+T快捷键；problemMatcher配"$pytest"支持错误跳转；所有路径用${workspaceFolder}变量保证跨平台兼容。
VSCode 里配测试任务不是为了“加个按钮”，而是让 pytest、dotnet test 或 npm test 在所有开发者机器上行为一致——配错 presentation 会导致终端不弹出，漏掉 dependsOn 会让清理步骤被跳过，环境变量没继承则 python -m pytest 直接报 command not found。
tasks.json 必须放对位置且 version 不能写错
VSCode 只在打开「文件夹」（不是单个文件）时读取 .vscode/tasks.json，路径必须是项目根目录下的 .vscode/tasks.json，多一层、少一层、拼成 task.json 都无效。
-
version字段必须是字符串"2.0.0"，写成2.0、"2"或直接删掉，整个文件会被静默忽略 - 如果项目用的是 Python 虚拟环境，别指望 VSCode 自动加载
venv/bin/activate——command得写全路径，比如"command": "./venv/bin/python"，再通过args传["-m", "pytest"] - Windows 下注意换行和路径分隔符：
"windows": { "command": "venv\Scripts\python.exe" }是合法的条件覆盖写法
pytest 任务要显式控制终端行为，否则输出看不见
很多团队配完 pytest 任务后点 Ctrl+Shift+P → Run Task 没反应，其实是终端没自动展开，输出被吞了。
- 必须加
"presentation": { "reveal": "always", "panel": "shared", "clear": true }，否则默认是"silent"，跑完了也不弹窗 -
"group": "test"不只是分类标签——它让Ctrl+Shift+T（测试快捷键）能识别该任务；没这个字段，就只能靠命令面板手动搜label - 想让测试失败时自动跳转到错误行？得配
"problemMatcher": ["$pytest"]，但前提是你的pytest输出格式匹配 VSCode 内置 matcher，否则得自定义正则
dotnet test 和 npm test 的环境变量陷阱
dotnet test 和 npm test 看似简单，实际最容易在 CI 或新成员本地跑挂，核心是环境变量不继承。
- VSCode 默认用非交互式 shell（
/bin/sh或cmd.exe），不 source~/.zshrc，所以即使终端里能敲dotnet，任务里写"command": "dotnet"就会报'dotnet' is not recognized - 解决方案二选一：
– 显式写全路径："command": "/usr/local/share/dotnet/dotnet"（macOS/Linux）或"command": "C:\Program Files\dotnet\dotnet.exe"（Windows）
– 改用"type": "shell"并把整条命令写进command字段："command": "dotnet test --nologo" -
npm test同理：如果依赖node_modules/.bin下的本地二进制（比如jest），不要拆成"command": "npm", "args": ["test"]，而应写"command": "npx jest"或直接"command": "npm test"（此时type必须为"shell"）
共享任务的关键是剥离个人路径和硬编码参数
一个能放进 Git 的 tasks.json，绝不能出现 /Users/yourname/... 或 C:Usersyourname... 这类路径，也不能假设所有机器都装了全局 pnpm。
- 用
cwd字段指定工作目录，比如"cwd": "${workspaceFolder}/tests"，避免相对路径错位 - 测试命令中涉及配置文件路径（如
--config pytest.ini）一律用${workspaceFolder}变量，别写死./pytest.ini - 需要区分开发/CI 场景？用
os条件块："linux": { "command": "python3" }，"windows": { "command": "py" } - 最常被忽略的一点：
dependsOn依赖的任务label必须完全一致（包括空格和大小写），且被依赖任务本身也要在同一个tasks.json里定义——跨文件引用不支持
真正难的从来不是写对第一行 JSON，而是确保 presentation.clear 没被误删、problemMatcher 对得上输出格式、以及所有路径变量在 Windows/macOS/Linux 上都能展开。这些细节不验证一遍，共享就只是把问题复制给所有人。
