TypeScript类枚举const定义在VSCode可用，NextJS构建时未定义如何解决？

问题根源 #

你当前定义的NodeEnvironment包含两部分：一个运行时常量对象和一个类型别名。你在代码中使用的NodeEnvironment.Development是运行时常量，而非纯类型——TypeScript只会擦除类型信息，运行时常量必须显式导入才能被识别，这就是构建时提示“NodeEnvironment未定义”的原因。而你之前的其他类型仅作为类型存在，编译后被完全擦除，因此不需要导入，但常量不属于这个范畴。

适配Next.js isolatedModules=true的解决方案 #

方案1：规范导入运行时常量（最稳妥）

保持你当前的定义方式，在类型包中同时导出常量和类型，然后在应用中显式导入常量：

1. 在类型包中导出：

export const NodeEnvironment = {
  Production: 'production',
  Development: 'development',
  Test: 'test',
} as const;

export type NodeEnvironment = (typeof NodeEnvironment)[keyof typeof NodeEnvironment];

2. 在应用中导入并使用：

import { NodeEnvironment } from '@your-types-package';

export const isDev = process.env.NODE_ENV === NodeEnvironment.Development;

Next.js的Tree Shaking会自动优化代码，最终编译后的JS会将NodeEnvironment.Development替换为字面量'development'，同时保证类型提示和自动补全正常。

方案2：使用const enum（满足“无需导入运行时值”需求）

const enum在编译时会被直接替换为字面量，不会生成运行时变量，适配isolatedModules=true需要调整配置：

1. 在类型包中定义并导出const enum：

export const enum NodeEnvironment {
  Production = 'production',
  Development = 'development',
  Test = 'test',
}

2. 调整Next.js的Babel配置（在next.config.js或babel.config.js中），确保支持const enum的内联：

module.exports = {
  presets: [
    ['next/babel', {
      'preset-typescript': {
        constEnums: true
      }
    }]
  ]
};

3. 在应用中仅导入类型即可使用：

import type { NodeEnvironment } from '@your-types-package';

export const isDev = process.env.NODE_ENV === NodeEnvironment.Development;

编译后的JS会直接生成const isDev = "development" === "development";，完全符合你的预期，同时不需要导入运行时常量。

注意事项 #

• 避免使用普通TypeScript枚举：普通枚举会生成运行时对象，在isolatedModules=true下会触发编译错误，且无法被Tree Shaking优化。
• 若选择方案2，需确保所有消费该类型包的应用都配置了对应的Babel选项，否则会出现编译错误。

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