React Native Expo项目相对导入遇TS2307错误求助

问题梳理 #

使用路径别名导入constants/Colors时触发TypeScript错误：Cannot find module 'constants/Colors' or its corresponding type declarations.ts(2307)，但应用可正常编译。已尝试删除node_modules重新安装、重启TS服务器，且文件位置与类型定义均无误。

当前tsconfig.json配置：

{
  "baseUrl": ".",
  "extends": "expo/tsconfig.base",
  "compilerOptions": {
    "strict": true
  },
  "paths": {
    "components/*": ["components/*"],
    "constants/*": ["constants/*"]
  }
}

具体修复步骤 #

• 修正tsconfig.json结构
  你的配置中baseUrl和paths被错误放在了compilerOptions外部，TypeScript无法识别这些路径规则。正确配置如下：

  {
    "extends": "expo/tsconfig.base",
    "compilerOptions": {
      "strict": true,
      "baseUrl": ".",
      "paths": {
        "components/*": ["components/*"],
        "constants/*": ["constants/*"]
      }
    }
  }
  

• 手动清除TypeScript缓存
  执行命令强制清除TS缓存，再重启编辑器的TS服务：

  npx tsc --clearCache
  

• 校验文件路径大小写
  若使用Linux/macOS系统，注意路径大小写敏感问题，确保导入语句中的constants/Colors与实际文件路径的大小写完全一致。

• 补充类型声明（按需）
  如果constants/Colors是JavaScript文件，可在项目根目录创建types/constants.d.ts文件补充类型声明：

  declare module 'constants/Colors' {
    export const primary: string;
    // 补充你实际导出的变量类型
  }
  

• 升级Expo版本
  旧版Expo的tsconfig.base可能覆盖自定义路径配置，尝试升级到最新稳定版：

  npx expo upgrade
  

内容的提问来源于stack exchange，提问作者photo-pizza-important