vscode需启用npm脚本探测并确保package.json位于工作区根目录才能显示可运行任务；通过命令面板或npm scripts视图可快速执行，多脚本组合需借助npm-run-all等工具定义新script。
VSCode 里直接运行 package.json 里的 npm 脚本，不需要装插件、不用手动敲命令——关键是把 scripts 正确暴露成可点击任务。
npm 脚本为什么在 VSCode 里不自动显示为可运行任务？
VSCode 默认只识别部分预设任务名（如 build、test、start），但不会自动扫描 package.json 全量 scripts。必须显式启用“npm 脚本探测”功能，且确保工作区根目录下有有效的 package.json。
-
package.json必须位于当前打开的文件夹根目录（不是子文件夹） - VSCode 设置中需开启
"npm.enableScriptExplorer": true（默认已开启，但某些旧版本或远程开发环境可能关闭） - 脚本名不能含空格或特殊字符（如
"dev:server"可用，"dev server"会失败）
如何快速触发 npm 脚本（不敲命令行）？
最常用的是通过命令面板调出脚本列表，或使用侧边栏的脚本浏览器。两者底层都依赖同一套任务发现机制。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入npm，选择NPM: Run Script—— 会列出所有scripts条目 - 打开侧边栏的
Explorer视图，点击顶部...→Focus on NPM Scripts View（或直接按Ctrl+Shift+Y）—— 脚本以树形结构展示，双击即可运行 - 右键
package.json文件 →Run Script→ 选择目标脚本（仅限该文件所在目录）
运行时提示 “Cannot find module” 或卡在 “Running task…”？
这通常不是 VSCode 问题，而是 npm 执行上下文没对齐：VSCode 启动的任务默认使用系统 PATH 中的 npm，但项目可能依赖本地 node_modules/.bin/npm 或 nvm 管理的 Node 版本。
- 检查 VSCode 终端是否和外部终端行为一致：在 VSCode 内建终端执行
which npm和node -v，对比你平时使用的终端 - 若使用 nvm / fnm / volta，在 VSCode 设置中添加：
"terminal.integrated.env.linux": { "PATH": "/home/xxx/.nvm/versions/node/v18.17.0/bin:$PATH" }（路径按实际调整） - 避免全局安装的
npm和项目engines不兼容 —— 比如项目要求"node": ">=16.14.0"，而全局 npm 对应的是 Node 14
想一键运行多个脚本（比如先 build 再 serve）怎么办？
VSCode 原生不支持串联任务，但可以用 npm 自身能力绕过：在 package.json 里定义组合脚本，VSCode 就能照常识别。
"scripts": {
"dev": "run-p build watch",
"build:watch": "npm-run-all build --parallel watch"
}
前提是已安装 npm-run-all 或 concurrently；VSCode 只管运行 dev 这个名字，后续逻辑由 npm 处理。注意：不要在脚本里写 && 后台进程（如 npm run build && npm run serve &），VSCode 无法正确捕获子进程输出和退出状态。
真正容易被忽略的是：VSCode 的脚本任务是“单次触发”，没有内置重载或热更新感知——哪怕你配置了 nodemon 或 webpack serve，只要终端关闭或进程退出，就得手动再点一次。别指望它自动接管 dev server 生命周期。
