VSCode中npm命令失效的根源是终端未继承系统PATH，而非Node或VSCode需重装；应先用where/npm验证路径，再通过code .从已加载PATH的终端启动VSCode，并用npm pkg set type=module补全package.json。
VSCode 里 npm 命令失效、package.json 缺关键字段、甚至 npm init 没反应——不是重装 Node 或 VSCode，而是工作区环境配置被污染或未继承。一键重置的核心是：**切断旧路径依赖、强制刷新环境变量、重建最小可用配置**。
终端没识别 npm？先确认是否继承了系统 PATH
VSCode 集成终端（Ctrl+`）默认不自动加载 shell 的完整环境变量，尤其在 Windows PowerShell 下容易丢失 npm 路径。
- 在 VSCode 终端里运行
node -v和npm -v：如果前者有输出后者报错，说明 Node 已安装但 npm 未被发现 - 在系统终端（如 Windows Terminal 或 macOS Terminal）中运行
where npm（Windows）或which npm（macOS/Linux），记下完整路径，例如C:\Program Files\nodejs\npm.cmd或/opt/homebrew/bin/npm - 不要手动改 VSCode 的
settings.json加 PATH——这治标不治本；正确做法是重启 VSCode 时从系统终端启动：code .（macOS/Linux）或code .从已加载 PATH 的 PowerShell 启动（Windows）
npm init -y 生成的 package.json 缺 type: "module" 怎么补全
Node.js ≥14.13 默认仍用 CommonJS，但现代项目普遍需要 ES Module 支持，import 会直接报 ERR_REQUIRE_ESM。
- 别手动编辑
package.json再保存——容易格式错误或漏逗号；用命令一步写入：npm pkg set type=module - 如果提示
command not found: npm pkg，说明 npm 版本太低（npm install -g npm@latest - 加了
"type": "module"后，所有.js文件按 ESM 解析：require()会失效，__dirname不可用，需改用import.meta.url
npm 命令被拦截为 ps1 脚本？删掉冲突的 npm.ps1
PowerShell 默认禁止执行未签名脚本，而某些 Node 安装包或旧 npm 全局安装会在 %appdata%\npm\ 下生成 npm.ps1，导致终端报错：npm : 无法将"npm"项识别为 cmdlet...。
- 运行
Get-ExecutionPolicy查看当前策略；若为Restricted，临时放宽：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（仅当前用户） - 更彻底的解法：直接删除冲突文件。在 PowerShell 中运行：
Remove-Item "$env:APPDATA\npm\npm.ps1" -Force - 验证是否生效：
npm -v应立刻返回版本号；若仍失败，检查$env:PATH是否含$env:APPDATA\npm
工作区级环境隔离：用 nvm 或 fnm 管理 Node 版本
全局 Node/npm 配置混乱时，靠“重置”不如“隔离”。VSCode 工作区应绑定明确的 Node 版本，避免跨项目污染。
- Windows 推荐
nvm-windows，macOS/Linux 推荐fnm（更快、Rust 实现）；安装后，在项目根目录运行：fnm use --install v18.20.2 - VSCode 会自动读取
.node-version或.nvmrc文件，无需额外配置；打开终端即切换到指定版本 - 验证：
node -v和npm -v输出应与fnm current一致；npm init -y生成的package.json可立即配合npm pkg set type=module补全
真正卡住的往往不是命令本身，而是 VSCode 终端没拿到系统 PATH、PowerShell 拦截了 npm.ps1、或者项目没声明模块类型就硬写 import。重置不是清空重来，而是精准清理那几个关键点：路径继承、执行策略、模块声明、版本绑定。
