TS/yarn私有包问题：导出const对象值无法在消费应用中访问

问题根源 #

当包中存在同名的const对象（值）和类型，并通过export * as Constants聚合导出时，tsup生成的类型定义文件（.d.ts）会出现歧义——消费端只能识别到PlayState作为类型，无法识别它作为值的存在。这是因为TS的类型系统和值系统虽独立，但聚合导出在类型生成时会优先覆盖同名标识符，加上yarn link本地包的类型解析机制放大了这个问题。

解决方案 #

1. 调整包的导出方式（核心修复） #

避免使用export * as Constants这种聚合导出，改为显式分离值和类型的导出，消除命名歧义：

方案A：直接导出所有成员（推荐）

修改包的index.ts：

// ./index.ts
// 显式导出值和类型，对同名类型可重命名避免混淆（可选）
export { On, Off, PlayState } from "./types/constants.js";
export type { OnOff, PlayState as PlayStateType } from "./types/constants.js";

消费端使用方式：

import { On, Off, PlayState, OnOff, PlayStateType } from "@author/pkg";

const a: OnOff = On; // 正常
const b: PlayStateType = "play"; // 正常
const c: PlayStateType = PlayState.Play; // 正常访问值

方案B：保留Constants命名空间

如果需要保留原有命名空间结构，修改包的index.ts：

// ./index.ts
import * as Constants from "./types/constants.js";

// 导出值
export const Constants = {
  On: Constants.On,
  Off: Constants.Off,
  PlayState: Constants.PlayState,
};

// 导出类型，单独声明命名空间的类型
export namespace Constants {
  export type OnOff = Constants.OnOff;
  export type PlayState = Constants.PlayState;
}

消费端使用方式和之前一致，此时Constants.PlayState既可以作为类型，也可以作为值访问。

2. 确保tsup的类型生成配置正确 #

在tsup.config.ts中明确开启类型生成，并确保配置完整：

import { defineConfig } from "tsup";

export default defineConfig({
  entry: ["src/index.ts"], // 替换为你的入口文件路径
  format: ["cjs", "esm"], // 按需输出模块格式
  dts: true, // 必须开启，确保生成完整的.d.ts文件
  clean: true, // 编译前清理输出目录
  sourcemap: true, // 可选，方便调试
});

3. 重新编译并刷新本地链接 #

• 在包目录执行yarn build重新编译，确保新的类型文件生成
• 在消费端执行：

  yarn unlink @author/pkg
  yarn link @author/pkg
  

• 重启消费端的TypeScript服务（比如VSCode中按Ctrl+Shift+P，选择TypeScript: Restart TS Server），确保类型缓存刷新

验证 #

修改完成后，消费端的以下代码应该可以正常编译：

import { Constants } from "@author/pkg";

const a: Constants.OnOff = Constants.On;
const b: Constants.PlayState = "play";
const c: Constants.PlayState = Constants.PlayState.Play; // 不再报错

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