VS Code中文件存在却报“Module Not Found”错误的解决方法

以下是针对你遇到的「文件存在且可跳转，但VS Code仍报导入错误」问题的可能原因及调试步骤：

• 清理TypeScript编译缓存
  重启TS服务器无效时，直接清理项目的TS编译缓存：

  1. 删除项目根目录下的.tsbuildinfo文件
  2. 执行命令 npx tsc --clean 清除编译输出目录
  3. 关闭VS Code后重新打开项目

• 检查目标CSS文件的语法与命名
  即使文件能跳转，CSS语法错误或特殊命名可能导致TS类型解析失败：

  • 检查CSS文件是否有未闭合的括号、非法字符（比如中文标点）
  • 确认类名是否包含TS无法解析的特殊格式（如连续下划线、非ASCII字符）
  • 若使用CSS变量，检查变量定义是否符合规范（如--var-name: value;）

• 验证TypeScript配置的一致性
  项目中多tsconfig.json的局部配置可能覆盖全局规则：

  • 检查当前文件所在目录的tsconfig.json（如果存在），确认moduleResolution、baseUrl、paths设置与全局配置一致
  • 全局tsconfig.json的include字段需包含.module.css文件路径，避免被exclude规则意外排除
  • 确认compilerOptions.types中已包含CSS Modules相关类型定义（如@types/css-modules）

• 排查VS Code插件与工作区缓存
  插件冲突或工作区缓存损坏也可能导致误报：

  1. 临时禁用所有非官方的CSS、TS相关插件（如第三方lint工具），重启VS Code后查看报错是否消失
  2. 打开命令面板（Cmd+Shift+P），执行「Clear Editor History」清除编辑器缓存
  3. 备份并删除项目根目录.vscode文件夹，重新打开项目重置工作区配置

• 重置CSS Modules类型文件
  若使用自动生成.d.ts的工具（如typed-css-modules），可能类型文件损坏：

  1. 删除目标CSS文件对应的.d.ts文件
  2. 手动执行类型生成命令（如npx tcm ./IntegrationAssetCard.module.css）
  3. 检查工具配置，确认已监听该文件所在目录的变化

内容的提问来源于stack exchange，提问作者machineghost