WebStorm报TS2305错误：模块"constants"无导出成员ARRAY的解决方法

问题场景 #

搭建了Vite + React + TypeScript项目，目录结构如下：

src
  constants
    a.ts
    b.ts
    index.ts
  components
    Comp.tsx

tsconfig.json中配置了"baseUrl": "src"，各文件代码如下：

• a.ts:

  export const ARRAY = [1, 2, 3];
  

• b.ts:

  export const Object = { foo: 'bar' };
  

• constants/index.ts:

  export * from './a';
  export * from './b';
  

• Comp.tsx:

  import { ARRAY } from 'constants';
  

项目运行完全正常，但WebStorm在Comp.tsx中抛出错误：

TS2305: Module "constants" has no exported member ARRAY

错误原因 #

1. WebStorm的TypeScript服务缓存了旧的类型解析信息，未同步最新的文件导出内容
2. WebStorm未正确识别tsconfig.json中的baseUrl配置，导致路径解析异常
3. 项目目录的源码根目录标记异常，WebStorm未将src/constants识别为可解析的模块路径

修复方案 #

1. 清除WebStorm缓存并重启 #

这是解决缓存类问题最快速的方法：

• 点击顶部菜单栏 File -> Invalidate Caches...
• 在弹出窗口中勾选 Clear file system cache and Local History
• 点击 Invalidate and Restart，等待IDE重启后检查错误是否消失

2. 确认并完善tsconfig配置 #

• 检查tsconfig.json是否在项目根目录，且WebStorm已正确加载该配置：
  进入 Settings -> Languages & Frameworks -> TypeScript，确认TS config file选择的是项目根目录下的tsconfig.json
• 可在tsconfig.json中添加paths配置强化路径映射：

  {
    "compilerOptions": {
      "baseUrl": "src",
      "paths": {
        "constants": ["constants/index.ts"],
        "constants/*": ["constants/*"]
      }
      // 其他配置项...
    }
  }
  

  该配置会明确告知TypeScript和WebStorm，constants模块对应的具体文件路径

3. 确认目录的源码根目录标记 #

右键项目中的src目录，选择 Mark Directory as -> Sources Root，确保WebStorm将src识别为源码根目录，这样基于baseUrl的路径才能被正确解析

4. 临时方案（不推荐） #

如果上述方法暂时无效，可临时修改导入路径为相对路径：

import { ARRAY } from '../constants';

但该方法会破坏baseUrl的配置优势，仅作为临时排查使用

内容的提问来源于stack exchange，提问作者Илья