VSCode本身不管理Node.js模块缓存，所谓“失效缓存”实为项目级或全局npm/yarn/pnpm行为；清理需直击文件系统和进程层，先杀node进程再删node_modules、锁文件及全局缓存，最后重装依赖。
VSCode 本身不管理 Node.js 的模块缓存或 node_modules，所谓“失效的 Node.js 缓存”实际是项目级或全局的 npm/yarn/pnpm 行为，VSCode 只是调用它们——清理必须绕过编辑器 UI，直击文件系统和进程层。
为什么在 VSCode 里点“重启终端”或“重装插件”没用
VSCode 的集成终端（Terminal）只是 shell 的封装，node、npm、yarn 进程由系统 PATH 决定，不是 VSCode 自带的。你看到的“模块找不到”“require 报错”“npm start 启动失败”，根源在：
• 当前终端会话中 node 进程已加载旧版模块（如 node_modules/.cache 或 require.cache）
• 全局安装的 CLI 工具（如 create-react-app、next）版本与项目不匹配
• package-lock.json 锁定的依赖树被手动篡改或未同步
- VSCode 不会自动清空
node_modules/.cache，也不会重置require.cache—— 这是 Node.js 运行时行为，需显式触发 - 插件如 “ESLint” 或 “Prettier” 若报“无法加载配置”，大概率是它们的 node_modules 子依赖被破坏，而非 VSCode 缓存问题
- 别信“设置里勾选‘清除 Node 缓存’”——VSCode 没这个开关
清理 node_modules 和本地依赖缓存的实操步骤
目标：让 npm install 或 yarn install 从干净状态重建，不残留损坏符号链接或半解压包。
- 先关闭所有 VSCode 终端窗口（包括隐藏的“后台任务”），再执行：
killall node（macOS/Linux）或taskkill /f /im node.exe（Windows）——否则node_modules被占用，删不掉 - 删
node_modules和锁文件：rm -rf node_modules package-lock.json（npm）或rm -rf node_modules yarn.lock（yarn）；pnpm 用户加pnpm store prune - 清 npm 全局缓存（仅当全局 CLI 失效时）：
npm cache clean --force；yarn 对应yarn cache clean；pnpm 是pnpm store gc - 重新安装：
npm install（不要用npm ci，除非你确认 lock 文件完整）
VSCode 插件调用 Node.js 失败？重点查 ms-vscode.node-debug2 和语言服务器缓存
插件如 “Debugger for Chrome”、“ESLint”、“TypeScript” 实际依赖独立的语言服务器二进制，它们常把 Node.js 运行时副本和模块缓存塞进 VSCode 扩展目录，而非项目内。
- 路径规律：
~/.vscode/extensions/ms-vscode.node-debug2-*（或dbaeumer.vscode-eslint-*）下的node_modules子目录，可能含损坏的eslint或typescript包 - 更常见的是
ms-vscode.vscode-typescript-next插件在~/.vscode/extensions/ms-vscode.vscode-typescript-next-*/server/下缓存了旧版 TS 服务，导致“跳转定义失败” - 安全做法：只删扩展名带
-cache或-dev后缀的文件夹（如ms-vscode.vscode-typescript-next-5.4.0-cache），保留ms-vscode.vscode-typescript-next-5.4.0 - 删完重启 VSCode，它会自动重下最新版语言服务器，比禁用/重装插件更彻底
环境变量污染导致 VSCode 找不到 node 或 npm
VSCode 继承启动它的 shell 环境变量。如果你用 Homebrew、nvm、volta 或 Windows 的 Scoop 安装 Node.js，而 VSCode 是从桌面图标启动（非终端中执行 code），它很可能读不到正确的 PATH。
- 验证方法：在 VSCode 集成终端中运行
which node和echo $PATH，对比你在系统终端里得到的结果 - macOS 常见坑：
launchctl setenv PATH设置无效，必须在~/.zprofile或~/.zshrc中导出PATH，并确保 VSCode 从该 shell 启动（终端里输入code .） - Windows 用户若用 nvm，要确认
nvm use已生效，且 VSCode 是以管理员权限外的普通用户身份启动（否则可能读取不同用户的环境变量） - 临时绕过：在 VSCode 设置里搜
terminal.integrated.env，手动添加"PATH": "/opt/homebrew/bin:/usr/local/bin"（按你真实路径填）
真正卡住的从来不是 VSCode 界面，而是你没意识到 node 进程还在后台 hold 着旧模块，或是扩展偷偷用了自己打包的 Node.js 副本。动手前先 ps aux | grep node，删缓存前先杀进程——这是最容易被跳过的一步。
