VSCode依赖项检查_Node.js或其他依赖项问题

vscode报“module not found”但终端正常，主因是语言服务未正确识别node_modules路径，常见于pnpm/yarn workspaces或打开路径非项目根目录，需检查tsconfig.json、node版本一致性及ts server状态。

VSCode 报 “Module not found” 但终端能跑通

这是最典型的依赖项检查错位现象：VSCode 的 JavaScript/TypeScript 语言服务（由 TypeScript Server 驱动）没读到你项目里实际安装的 node_modules，或者读到了错误的版本。常见于使用 pnpm 或 yarn workspaces 的单体仓库，或 VSCode 打开的路径不是真正的项目根目录。

• 确认 VSCode 左下角显示的 Node.js 版本和你在终端运行 node -v 是否一致；不一致说明 VSCode 没继承 shell 环境变量，需在 VSCode 设置中启用 typescript.preferences.includePackageJsonAutoImports 并重启 TS 服务
• 右键点击报错的 import 语句 → 选择 Go to Type Definition，如果跳转失败或提示“no definition found”，大概率是 tsconfig.json 的 baseUrl / paths 配置未被识别，或 node_modules/@types 缺失
• 运行 npm list <package-name></package-name>（如 npm list react）确认包确实存在且版本符合 import 调用方式；若用 pnpm，改用 pnpm ls <package-name></package-name>

TS Server 反复崩溃或无法识别新装的依赖

VSCode 底部状态栏出现 “TypeScript language features are disabled” 或频繁弹出 “Restart TS server” 提示，往往不是插件问题，而是类型定义加载异常。

Mokker AI

AI产品图添加背景

下载

• 检查项目根目录是否存在有效的 tsconfig.json；空文件、只含注释、或写成 tsconfig.base.json 但没被引用，都会导致 TS Server 降级为默认配置，忽略 node_modules 中的 @types
• 删除 node_modules/.pnpm（pnpm）或 node_modules/.cache（yarn）等缓存目录后重装依赖，旧缓存可能让 TS Server 加载了过期的类型声明
• 在 tsconfig.json 中显式启用类型自动导入：

  {"compilerOptions": {"types": ["node", "jest"], "allowSyntheticDefaultImports": true}}

  避免因缺少 @types/node 导致整个类型检查链断裂

ESLint / Prettier 报依赖缺失但 npm run lint 正常

VSCode 内置的 ESLint 插件默认从工作区根目录找 eslint，但它不会自动识别 pnpm 的硬链接结构或 volta 管理的二进制路径，容易报 Cannot find module 'eslint-plugin-react'。

• 在 VSCode 设置中搜索 eslint.packageManager，设为 "pnpm" 或 "yarn"（不能留空或设为 "npm"）
• 确保 .eslintrc.cjs 或 eslint.config.js 中的 plugins 和 extends 使用的包名与 package.json 中的 devDependencies 完全一致（注意大小写和横线）
• 如果项目用了 eslint-config-airbnb 这类组合包，必须同时安装它所依赖的子插件（如 eslint-plugin-import），否则 VSCode 插件会在解析时直接 throw，而 CLI 因有容错逻辑反而能继续

调试时断点失效，提示 “No source available”

这通常不是 Node.js 版本问题，而是 VSCode 的 launch.json 没正确映射源码路径，尤其在使用 TypeScript 编译或 monorepo 场景下。

• 确认 launch.json 中 outFiles 指向的是真实生成的 .js 文件路径，例如：

  "outFiles": ["${workspaceFolder}/dist/**/*.js"]

  而不是 ./build 或 ./lib（除非你真这么配）
• 检查 tsconfig.json 的 sourceMap 和 inlineSourceMap 是否为 true；二者不要同时启用，优先用 sourceMap: true + inlineSources: true
• 如果用 pnpm，某些调试器无法穿透 node_modules/.pnpm 的嵌套 symlink，可在 launch.json 加上：

  "resolveSourceMapLocations": ["!**/node_modules/**"]

  跳过对依赖源码的映射尝试