npm run build 能直接运行的前提是 vscode 正确识别项目根目录下的合法 package.json；需确保工作区为顶层目录、scripts 字段语法正确、未被排除、终端加载了正确的 shell 环境。
能直接跑 npm run build，前提是 VSCode 正确识别了你的项目结构和脚本定义——不是所有 package.json 都能自动变成可点击任务，也不是所有终端环境都能顺利执行。
为什么 npm run build 在 VSCode 里不显示或报错 “Missing script”
VSCode 不会主动扫描任意位置的 package.json，它只认当前工作区根目录下的文件。常见卡点：
- 你打开的是子文件夹（比如
src/或packages/core/），而不是含package.json的项目顶层目录 -
scripts字段为空、只有注释、用了单引号（'build': 'tsc'）或尾逗号导致 JSON 解析失败 -
package.json被.vscode/settings.json中的files.exclude或search.exclude意外屏蔽 - Windows 上 PowerShell 执行策略禁用脚本，连终端都启动失败，更别说加载 npm 脚本面板
如何让 npm run build 在侧边栏一键运行
必须满足两个硬性条件：项目根目录打开 + package.json 合法存在。之后操作才有效：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入NPM: Focus on Scripts View唤出面板 - 或点击资源管理器底部“…” → 勾选
NPM 脚本（首次启用后常驻） - 确保
"build"是合法脚本名：不能含空格，不能以数字开头，值必须是字符串（如"build": "vite build"） - 双击
build即执行；右键可选“Run Script in Terminal”（新开终端，避免干扰 dev 服务）
通过 tasks.json 调用 npm run build 并附加后续操作
原生 NPM 脚本面板不支持链式命令（比如构建完自动压缩），得靠 tasks.json 封装：
- 在
.vscode/tasks.json中写清楚工作目录："cwd": "${workspaceFolder}" -
"type": "shell"必须显式声明，否则不走 shell 环境，npm可能找不到 - 参数要用数组形式：
"args": ["run", "build"]，写成"args": ["run build"]会报Missing script - 想构建后压缩？别拼
&&：Windows 没zip，macOS/Linux 没7z。推荐统一用npx archiver-cli dist dist.zip（先npm install --save-dev archiver-cli）
终端里跑 npm run build 却提示 command not found
这不是 npm 没装，而是 VSCode 终端没加载你的 shell 初始化文件（比如 ~/.zshrc），导致 nvm 切换的 Node 版本、本地 node_modules/.bin 路径都没生效：
- 在 VSCode 终端执行
which node和echo $PATH，对比系统终端输出是否一致 - 若不一致，在设置中搜
terminal.integrated.profiles，为 zsh/bash 添加"args": ["-l"]（-l表示 login shell，会加载 profile） - Windows 用户注意：默认终端可能是 PowerShell，但
npm命令可能只在 CMD/WSL 中可用。可在tasks.json中指定"options": {"shell": {"executable": "cmd"}}
真正容易被忽略的是：VSCode 的终端环境和你日常使用的终端不一致时，npm run build 行为可能完全不同——比如本地 tsc 找不到、CROSS_ENV 不生效、甚至构建产物路径错乱。验证方式永远是：在 VSCode 终端里手动跑一遍，别只依赖面板点击。
