vscode tasks 调用 npm run build 需以项目根目录打开、设 "cwd": "${workspacefolder}" 和 "type": "shell"；build 后压缩推荐 npx archiver-cli 或新增 build:zip 脚本；避免路径空格引号陷阱，用 args 数组而非拼接字符串。
VSCode Tasks 怎么调用 npm run build
VSCode 的 Tasks 系统本身不执行 npm 命令，而是通过 Shell 或 Node.js 运行时间接调用。关键在于让 Task 正确识别项目根目录下的 package.json 和本地 node_modules/.bin 路径。
常见错误是 Task 在错误工作目录下启动，导致报错 npm ERR! Missing script: "build" 或直接找不到 npm 命令——这通常是因为 VSCode 没读到你打开的文件夹是项目根目录，或者没启用 "isShellCommand": true。
- 确保 VSCode 是以项目根目录（含
package.json的文件夹）为工作区打开的 - 在
.vscode/tasks.json中显式指定"cwd": "${workspaceFolder}" - 必须设
"type": "shell"（旧版用"isShellCommand": true），否则默认走进程模式，不加载 shell 环境变量，npm可能不可见 - Windows 用户注意：如果用 Git Bash 或 WSL 作为默认终端，Task 默认仍走 cmd/PowerShell，需在
tasks.json里加"options": {"shell": {"executable": "bash"}}（路径按实际调整）
怎么在 build 后自动压缩 dist 目录
Tasks 支持链式执行，但不能直接写两行命令就自动串起来；需要靠 &&（Linux/macOS）或 &&（Windows cmd）做逻辑连接，或改用 Node.js 脚本封装。
直接拼接命令最轻量，也最容易出问题：比如 npm run build && zip -r dist.zip dist/ 在 Windows 上会失败，因为 zip 不是内置命令；而 npm run build && powershell Compress-Archive -Path dist -DestinationPath dist.zip 又依赖 PowerShell 版本（5.1+）。
- 推荐统一用 cross-platform 方案：
npm run build && npx archiver-cli dist dist.zip（需先npm install --save-dev archiver-cli） - 若不想装额外包，可在
package.json里新增脚本："build:zip": "npm run build && tar -czf dist.tar.gz dist/"（macOS/Linux）或用7z（需预装） - 注意
dist目录是否在build完成后立刻存在——有些框架（如 Vite）会在构建前清空它，但 Webpack 默认不清理，得确认你的构建配置是否输出稳定
tasks.json 中怎么避免路径和引号陷阱
VSCode Tasks 对空格、中文路径、特殊字符极其敏感；args 字段里多一个空格或少一对引号，就会静默失败或报错 spawn npm ENOENT。
根本原因是 VSCode 把 args 数组每个元素当独立参数传给 shell，而不是拼成一行字符串。所以 "args": ["run", "build"] 安全，但 "args": ["run build"] 就会当成一个命令名去搜，找不到。
- 永远用
"args"数组，别用"command"拼整条命令（除非你明确控制 shell 解析） - 路径含空格时，不要手动加引号：
"${workspaceFolder}/src"VSCode 会自动处理；但如果你写"args": ["--outDir", "${workspaceFolder}/build output"]，就得改成"--outDir","${workspaceFolder}/build output"两个数组项 - Windows 下避免用反斜杠
写路径，一律用正斜杠/或双反斜杠\；${workspaceFolder}本身返回的是正斜杠格式，兼容性最好
为什么 build 成功了但压缩没触发
这不是 VSCode 的 Bug，而是 Task 的“成功判定”逻辑太宽松：只要 npm run build 进程退出码是 0，VSCode 就认为整个 Task 成功，后续命令哪怕被跳过也不报错。
典型表现是：你在终端里手动运行 npm run build && zip ... 能压缩，但 Task 里只执行了前半段。原因往往是 && 没生效——比如用了 "type": "process"，或者 shell 解析器不支持该语法（如旧版 Windows cmd 不支持 &&，得用 &&）。
- 检查 Task 输出面板里有没有完整打印出压缩命令那行；没有，说明根本没走到那里
- 把压缩命令单独提成一个新 Task，手动运行测试，确认它本身可执行
- 终极方案：写一个
build-and-zip.js脚本，用child_process.execSync严格控制流程和错误传播，再让 Task 调用这个脚本
