根本原因是VSCode语言服务未正确定位node_modules，需统一Node版本、验证tsconfig.json有效性、清理pnpm缓存、显式配置types并重启VSCode。
VSCode报“Cannot find module”但终端能跑通
这不是 Node 环境没装好，而是 VSCode 的语言服务（TypeScript Server / JS language service）压根没定位到你项目里的 node_modules。常见于用 pnpm 或 yarn workspaces 的单体仓库，或 VSCode 打开的路径不是项目根目录。
- 先确认左下角显示的 Node.js 版本是否和终端里
node -v一致；不一致说明环境变量没继承过来 - 右键点击报错的
import语句 → “Go to Type Definition”，跳转失败就基本坐实路径识别问题 - 运行
npm list react（或你实际报错的包名）验证包确实存在；pnpm用户改用pnpm ls react - 检查项目根目录有没有有效的
tsconfig.json—— 空文件、只含注释、或名字是tsconfig.base.json但没被引用，都会让 TS Server 降级为默认配置
tsconfig.json 配置没生效
tsconfig.json 里写的 baseUrl 和 paths 对 import 路径起作用，但 VSCode 不一定读得到。尤其当你用的是 pnpm，它的硬链接结构会让 TypeScript Server 加载类型定义时走偏。
- 确保
compilerOptions.types显式包含"node"，否则连require、__dirname都标红：{"compilerOptions": {"types": ["node"]}} - 删掉
node_modules/.pnpm（或node_modules/.cache）后重装依赖，旧缓存可能让 TS Server 加载了过期的类型声明 - 如果用了
paths别名，确认baseUrl指向正确（通常是"./"），且 VSCode 打开的是该配置所在目录的父级
ESLint/Prettier 报 module not found 但 npm run lint 正常
VSCode 内置 ESLint 插件默认从工作区根找 eslint，但它不自动适配 pnpm 的二进制路径或 volta 的 wrapper，容易报 Cannot find module 'eslint-plugin-react'。
- 在 VSCode 设置中搜
eslint.packageManager，设为"pnpm"或"yarn"（不能留空，也不能设成"npm"） - 检查
.eslintrc.cjs或eslint.config.js里plugins和extends的包名，必须和package.json中devDependencies的实际名称完全一致（比如eslint-plugin-import≠@typescript-eslint/eslint-plugin） - 如果用了
pnpm，确保eslint是通过pnpm add -D eslint安装的，而不是全局或手动拷贝
插件开发时 require 失败但 node -e 能跑
VSCode 插件运行在独立扩展主机进程里，它不复用你的项目 node_modules，也不自动加载插件自身的依赖 —— 即使 package.json 里写了 dependencies，也得手动装进去。
- 打开插件源码目录（不是你的业务项目），运行
npm install，确保node_modules下有对应包（如axios、@dify/plugin-core） - 调试前务必执行
npm run compile（或npm run watch），否则require可能指向未构建的源文件路径 -
launch.json中的program必须指向编译后的入口，通常是${workspaceFolder}/out/extension.js，不是src/extension.ts - 别在
env里硬写NODE_PATH，它会干扰模块解析顺序，让插件去错地方找依赖
最易被忽略的点：VSCode 左下角显示的 Node 版本、右下角选中的 Python 解释器、.vscode/settings.json 里硬编码的 python.defaultInterpreterPath —— 这些看似无关的配置，一旦冲突，会直接让语言服务放弃加载 node_modules。改完任何一项，都得重启 VSCode，不是重开终端窗口。
