vscode的npm scripts侧边栏需同时满足三个条件才加载：项目根目录打开、package.json中scripts字段非空、vscode版本≥1.72；不显示主因是路径错误、配置排除或powershell策略限制，而非插件缺失。
VSCode 的 NPM Scripts 侧边栏不是“装完就出来”的功能，它只在满足三个硬性条件时才加载：项目根目录打开、package.json 存在且 scripts 字段非空、VSCode ≥ 1.72。不显示，90% 是路径或配置问题，不是插件没装。
为什么 NPM Scripts 面板根本没出现？
它不会自动弹窗，也不会在子目录里找 package.json——VSCode 只检查你用 File > Open Folder… 打开的那个文件夹的根目录。
- 你打开的是
src/或packages/ui/？立刻关掉，重新用Open Folder选对顶层目录 -
package.json被排除了？检查.vscode/settings.json里的"files.exclude"或"search.exclude"，确认没写"**/package.json": true -
scripts字段是空对象{}、只有注释、或用了单引号（'dev': 'vite'）？JSON 解析失败，VSCode 直接跳过 - Windows 用户用 PowerShell 启动 VSCode，但执行策略被禁？终端卡在
xxx.ps1 cannot be loaded because running scripts is disabled，面板根本初始化不了
怎么手动唤出并固定它？
面板图标是 /npm，位置在资源管理器（Explorer）底部，不是扩展栏。首次启用后才会常驻，必须主动拉出来：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入NPM: Focus on NPM Scripts View并回车 - 或点击左侧活动栏最下方的
…→ 勾选NPM Scripts（注意：这个选项只在检测到合法package.json后才出现） - 如果唤出后仍是空的，右键面板空白处选
Reload Scripts；仍不行就先执行Developer: Reload Window
双击 vs 右键运行，行为完全不同
表面都是点一下，但底层执行逻辑差异直接影响你能否传参、是否干扰开发服务器：
-
双击脚本名：默认复用同一个集成终端，适合
dev这类长期监听命令；但无法追加参数，比如不能跑npm run build -- --mode staging -
右键 → Run Script in Terminal：新开一个终端标签页执行，适合
test、lint这类一次性任务，避免和正在运行的开发服务冲突 -
右键 → Run Script with Arguments…：弹出输入框，只填参数部分（不含
npm run xxx），例如输--host 0.0.0.0 --port 4173，VSCode 自动拼成完整命令 - 终端复用行为由设置
terminal.integrated.reuseTerminal控制，默认为true；设为false可强制每次新开
高频脚本怎么一键触发？别靠记忆调命令面板
给 dev、build 绑快捷键，比反复打开侧边栏快得多：
- 按
Ctrl+K Ctrl+S（Win/Linux）或Cmd+K Cmd+S（Mac）打开快捷键设置 - 点右上角
+添加新快捷键，“命令”填npm.runScript，“键”按习惯设（如Ctrl+Alt+B） - “参数”字段必须是 JSON 对象：
{"script":"build"}（把build换成你要绑定的脚本名）
真正容易被忽略的是：VSCode 的集成终端启动时加载的 Node/npm 环境，和你在系统终端里手动激活的可能不一致——比如用了 nvm，但 VSCode 没执行过 nvm use 18，脚本就会用错版本，报 Cannot find module 或 peer dep 冲突。
