VSCode需≥1.72版、项目根目录含scripts字段的package.json，手动调出NPM Scripts面板（Ctrl+Shift+P→Focus on NPM Scripts View），确保终端Node/npm环境正确，多根工作区仅首文件夹生效。
VSCode 里点不亮 scripts 侧边栏？先确认插件和配置
VSCode 默认不显示 package.json 脚本侧边栏，必须启用内置的 **NPM Scripts Explorer** 功能——它从 VSCode 1.72 开始作为默认功能集成，但需要项目根目录下存在 package.json 且包含 scripts 字段。
常见错误现象：
– 打开项目后左侧没有「NPM Scripts」图标
– 点击资源管理器顶部的「…」也找不到「NPM Scripts」面板
– package.json 明明有 "scripts": { "dev": "vite" }，但就是不出现
- 检查 VSCode 版本是否 ≥ 1.72（
Help > About查看），旧版本需手动安装npm插件（如npm-intellisense不提供此功能，别装错） - 确保你打开的是项目**根文件夹**（即
package.json所在目录），不是子目录；VSCode 不会跨文件夹向上查找package.json - 确认
package.json文件未被 VSCode 排除（检查.vscode/settings.json中是否有"files.exclude"错误屏蔽了它）
怎么让 NPM Scripts 面板出现在侧边栏？
它不会自动弹出，得手动唤起。快捷方式比找菜单更可靠：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入npm，选择Explorer: Focus on NPM Scripts View - 或者直接点击左侧活动栏最底下的
…→More Actions...→ 勾选NPM Scripts（注意：这个选项只在检测到有效package.json后才出现） - 首次启用后，它会固定在资源管理器下方，图标是
?，标题为NPM Scripts
如果仍不显示，尝试关闭再重新用 File > Open Folder... 打开项目根目录——VSCode 的工作区状态有时不会热更新脚本列表。
点一下就运行失败？常见执行环境问题
VSCode 默认用集成终端运行脚本，但终端类型、Shell、Node/npm 版本不一致时，npm run dev 可能报错说找不到命令或模块未找到。
- 右键脚本 →
Run Script本质是在当前终端执行npm run xxx，所以它依赖你终端里可用的npm和node—— 不是你系统 PATH 里的，而是 VSCode 终端启动时加载的那个 - 如果你用了
nvm或fnm，确保终端已激活对应 Node 版本（比如打开终端后手动执行过nvm use 18），否则脚本可能用错 Node 版本导致peer dep报错 - Windows 用户注意：PowerShell 默认禁止执行本地脚本，报错
xxx.ps1 cannot be loaded because running scripts is disabled？改终端为Command Prompt或在 PowerShell 中运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
想自定义脚本执行行为？靠 settings.json 微调
VSCode 的 NPM Scripts 功能支持有限配置，但几个关键项能解决实际卡点：
- 默认使用当前工作区的
npm，但如果你项目用了pnpm或yarn，它仍然只认npm命令——没法直接切换底层包管理器，得自己改脚本名（比如把"dev"改成"dev:pnp"并写死pnpn dev） - 想让每次运行都新开一个终端页签？加配置：
"npm.scriptExplorer.autoOpenTerminal": true
- 避免脚本输出刷屏后快速消失？加配置：
"npm.scriptExplorer.showOutputChannel": true
这样输出会进独立的「NPM Scripts」输出面板，可滚动查看
这些配置写在工作区 .vscode/settings.json 里最稳妥，避免污染全局设置。
真正麻烦的是多根工作区（multi-root workspace）：VSCode 只会为**第一个文件夹**启用 NPM Scripts 面板，其他根目录下的 package.json 脚本不会显示——没绕过办法，只能分窗口开。
