嵌套导出时出现“模块默认导出存在或使用私有名称”错误求助

这个错误我之前维护TypeScript公共常量模块时也碰到过，核心原因是你默认导出的对象里包含了模块内部未显式导出的私有名称——TypeScript在做类型检查或生成声明文件时，无法追踪这些私有成员的可见性，因此抛出了这个错误。结合你的文件结构，我给你一步步的解决方案：

1. 确保子模块的所有成员都显式导出 #

先检查constants和locales下的子文件（比如status.ts、type.ts），确保所有需要被上层模块导出的常量/类型都用export关键字暴露出来，不能让它们成为模块内部的私有变量。

举个错误示例（会触发报错）：

// constants/status.ts - 错误写法
const STATUS = {
  ACTIVE: 'active',
  INACTIVE: 'inactive'
};
// 这里没有导出STATUS，上层模块引用后再导出就会触发私有名称错误

正确写法：

// constants/status.ts - 正确写法
export const STATUS = {
  ACTIVE: 'active',
  INACTIVE: 'inactive'
};

同理，locales下各语言目录的status.ts/type.ts也要遵循这个规则，比如：

// locales/zh-hk/status.ts - 正确写法
export const STATUS_LOCALE = {
  ACTIVE: '已激活',
  INACTIVE: '已停用'
};

2. 调整嵌套导出的方式，避免默认导出私有成员 #

优先使用命名导出代替默认导出，这样不仅能避免私有名称问题，还能让模块导出结构更清晰。

针对constants模块的导出 #

修改constants/index.ts，用命名导出聚合子模块的内容：

// constants/index.ts
export * from './status'; // 导出status.ts的所有命名成员
export * from './type';   // 导出type.ts的所有命名成员

// 或者如果需要聚合为一个对象导出：
import * as Status from './status';
import * as Type from './type';

export const constants = {
  ...Status,
  ...Type
};

针对locales模块的导出 #

修改locales下各语言目录的index.ts，先聚合子文件的导出：

// locales/zh-hk/index.ts
export * from './status';
export * from './type';

然后在根locales/index.ts里用命名导出聚合所有语言包：

// locales/index.ts
import * as en from './en';
import * as fr from './fr';
import * as zhHk from './zh-hk';

export const locales = {
  en,
  fr,
  'zh-hk': zhHk
};

3. 主模块index.ts的导出规范 #

最后在项目根目录的index.ts里，同样用命名导出对外暴露所有内容，避免默认导出：

// index.ts
export * from './constants';
export * from './locales';

// 或者聚合为统一入口：
import { constants } from './constants';
import { locales } from './locales';

export { constants, locales };

额外检查：tsconfig.json配置 #

如果你的tsconfig.json里开启了declaration: true（生成.d.ts声明文件），要确保相关配置不会加剧这个问题。推荐的相关配置：

{
  "compilerOptions": {
    "declaration": true,
    "declarationMap": true,
    "isolatedModules": true,
    "module": "ESNext",
    "target": "ES2020"
  }
}

核心思路就是：所有被上层模块导出的成员，必须在它所在的子模块里显式导出，杜绝引用私有名称后再导出的情况；同时尽量用命名导出替代默认导出，让模块的导出结构更透明，也能避免TypeScript的私有名称检查报错。

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