在 VSCode 中遇到 'Cannot find module' 错误，通常意味着 Node.js 解析模块时找不到对应的文件或包。这个错误可能出现在导入本地文件、第三方依赖或 Node.js 内置模块时。处理这类问题，关键是根据错误信息中的模块路径，结合项目环境逐步排查。下面是一种常见的排查思路，你可以根据具体场景取舍。
1. 确认错误上下文：模块类型与运行环境
错误信息会给出模块名称或路径，比如 Cannot find module 'lodash' 或 Cannot find module '../../utils/helper'。先判断是第三方包还是本地文件。第三方包需要检查 package.json 和 node_modules；本地文件则要核对路径和文件存在性。同时确认运行环境：是用 Node.js 直接跑脚本，还是通过 Webpack、Vite 等构建工具？不同环境下模块解析规则不同。例如，使用 ts-node 或 tsx 运行 TypeScript 时，需要额外的配置。
2. 检查 package.json 与 node_modules：安装与版本
如果模块是第三方包，先确认是否已安装。查看 package.json 的 dependencies 或 devDependencies 中是否有该包及其版本。然后检查 node_modules 目录下是否存在对应文件夹。有时版本冲突或安装不完整会导致模块缺失。可以尝试删除 node_modules 和 package-lock.json（或 yarn.lock），再重新运行 npm install 或 yarn install。如果项目使用了 monorepo 或 workspace，注意模块可能安装在根目录或子包的 node_modules 中，需要根据工作区配置确认。
3. 检查导入路径：相对路径、大小写与文件扩展名
对于本地文件导入，'Cannot find module' 常常是因为路径错误。先检查相对路径的层级是否正确，比如 '../../utils/helper' 是否准确指向目标文件。另外，文件系统是大小写敏感的（Linux/Mac），而 Windows 不敏感，但 VSCode 的智能提示可能忽略这一点。如果 helper.ts 实际文件名是 Helper.ts，在 Linux 上就会报错。建议统一使用小写命名或遵循团队规范。文件扩展名也需要留意：TypeScript 项目中，导入 './utils/helper' 时，如果没有配置 allowImportingTsExtensions 或使用 .js 扩展名，可能会解析失败。Node.js 16+ 支持 exports 字段，如果包使用该字段，导入路径需匹配其导出规则。
4. TypeScript 配置：tsconfig.json 的 paths、baseUrl 与 moduleResolution
在 TypeScript 项目中，tsconfig.json 的 compilerOptions 直接影响模块解析。常见配置项：
baseUrl：设置基础路径，所有非相对导入都相对于它解析。paths：定义路径映射，比如"@/*": ["src/*"]。如果代码中使用了import { helper } from '@utils/helper'，但paths没配置或映射错了目录，就会报错。moduleResolution：指定模块解析策略，node或bundler（TS5.0+）。使用bundler时，需要配合构建工具的支持。如果项目用 Webpack 或 Vite，通常moduleResolution要设置为bundler或node并配合allowSyntheticDefaultImports等选项。检查tsconfig.json是否与构建工具配置一致。可以先尝试注释掉paths和baseUrl，改用相对路径导入，看能否消除错误，这样能快速定位问题是否出在映射上。
5. 检查 VSCode 本身：TypeScript 版本与工作区信任
VSCode 内置的 TypeScript 版本可能与项目要求的版本不同。可以在 VSCode 的状态栏右下角点击 TypeScript 版本号，选择“使用工作区版本”。如果项目使用 tsc 编译没问题，但编辑器报错，通常是 VSCode 使用了不同的 TypeScript 版本。此外，VSCode 的工作区信任设置也可能影响某些功能。如果项目在不受信任的工作区中，部分验证功能会被禁用，可能导致模块解析提示异常。可以检查一下工作区信任状态。
6. 查看构建日志与 Node.js 模块路径
如果通过 npm scripts 运行项目，注意观察终端输出的详细错误堆栈。有时错误指向的是 Node.js 内置模块如 fs 或 path，如果被错误地覆盖或重名，也会报错。还可以检查 NODE_PATH 环境变量，它会影响 Node.js 的模块搜索路径。在 CI/CD 或 Docker 环境中，NODE_PATH 设置不当可能导致模块找不到。建议重启 VSCode 或 Node.js 进程，某些情况下缓存也会干扰模块解析。
以上是处理 'Cannot find module' 错误的常用检查点。不同项目的依赖和配置差异较大，建议根据具体的错误信息和项目结构，从最可能的环节入手，逐步缩小排查范围。遇到不确定的配置时，可以先搜索官方文档或社区同类问题的讨论，结合自身环境验证。