VSCode本身不打包，只运行命令；tasks.json必须正确配置type、dependsOn、isBackground、presentation等关键字段，且npm run build需在终端能通，环境PATH要匹配，部署应封装为脚本而非硬编码scp。
VSCode 本身不打包，它只运行你写的命令；能打包的前提是终端里 npm run build 能跑通，且项目结构、依赖、配置都就位。
tasks.json 必须写对的几个关键字段
VSCode 的任务系统靠 .vscode/tasks.json 驱动，不是靠插件或设置。漏掉任一关键字段，任务可能静默失败或并行错乱：
-
"type": "shell"：必须显式声明，否则 Windows 下默认用process模式，不支持&&或管道 -
"dependsOn": ["build"]仅声明依赖，但不保证执行顺序——还得配"dependsOrder": "sequence" -
"isBackground": false：不加这个，VSCode 可能认为“任务已启动”就放行后续操作，导致scp在dist/还没生成时就执行 -
"presentation": { "panel": "shared" }：复用同一个终端面板，避免每次打包都开新窗口、堆满历史记录
为什么 npm run build 在终端能跑，tasks.json 里却报 command not found
常见原因不是路径错，而是环境隔离：
- VSCode 内置终端启动时，不会自动加载 shell 的
~/.zshrc或~/.bash_profile，PATH可能不含node_modules/.bin - Windows 用户若用 Git Bash，VSCode 默认调用的是 PowerShell，
npm命令可能根本不在其PATH中 - 解决办法：在
tasks.json的command字段里直接写完整路径，比如"command": "npx webpack --mode production"，而不是"npm run build"；npx自动优先找本地node_modules/.bin下的可执行文件
Webpack 项目 task 不生效？先检查 webpack.config.js 是否被识别
VSCode 插件（如官方 Webpack 支持）只做静态分析，不运行代码。它能否读取配置，取决于三个硬性条件：
- 文件名必须是
webpack.config.js（或webpack.config.cjs），webpack.prod.js不会被自动探测 - 导出方式必须是
module.exports = { ... }；export default在多数插件中无效 - 文件必须放在项目根目录（即
package.json所在位置），不能放在config/子目录下
如果配置文件有语法错误，VSCode 通常只标红，但不会报错提示“配置未加载”，容易误判为任务配置问题。
别在 tasks.json 里硬编码 scp 或 rsync
直接写 "command": "scp -r dist/ user@host:/var/www/html" 看似简洁，实际极难调试：
- VSCode 任务不继承
ssh-agent，公钥认证大概率失败，报Permission denied (publickey) - 目标服务器路径权限、磁盘空间、SELinux 等问题全得靠日志反推，而任务输出面板常被截断
- 推荐做法：把部署逻辑抽成
./scripts/deploy.sh，用set -e控制失败退出，并在脚本里显式ssh创建目录、scp推送、ssh重启服务；tasks.json只负责调用该脚本
真正容易被忽略的点是：任务是否完成，不看“命令返回 0”，而要看终端输出是否稳定结束——有些 webpack --watch 类任务会持续运行，必须设 "isBackground": true 并配 "problemMatcher"，否则 VSCode 会卡住不响应。
