TypeScript 如何限制枚举仅可访问已定义成员，拦截非法属性访问

你遇到的属性访问无报错的核心是TS对JS文件的默认校验规则导致的：

• 项目虽然开启了allowJs配置，但这个配置仅允许TS将JS文件纳入编译范围，默认不会对JS代码做严格类型校验，JS文件里导入的TS枚举会被自动推断为any类型，自然访问任意自定义属性都不会触发提示。
• 你定义的字符串枚举本身没有开放通配字符串索引签名，只要TS能正确识别枚举的结构，访问未声明的属性（如BASE_ROUTES.foo）就会直接抛出类型错误。

第一步：开启JS文件的类型校验 #

两种方式按需选择即可：

• 渐进式方案（适合存量老项目重构，避免一次性暴露大量历史代码报错）：在所有需要访问枚举的JS文件头部新增一行// @ts-check注释，明确告知TS当前文件需要启用严格类型校验，配置完成后TS会自动识别从TS侧导入的枚举结构，访问未定义属性时就会触发警告。
• 全局方案（适合全量推进JS转TS的项目）：直接在当前tsconfig.json的compilerOptions字段新增"checkJs": true配置，开启后所有JS文件都会默认启用类型检查，无需逐个加注释。

第二步（可选优化，混编场景更稳定）：替换枚举为as const常量对象 #

TS枚举在JS侧的类型推导偶尔存在兼容问题，在TS/JS混编场景下，换成as const修饰的常量对象体验更稳定，运行时产出的代码和原字符串枚举完全一致，类型校验更严格：
将原枚举替换为如下定义：

export const BASE_ROUTES = {
  MODULES: 'modules',
  RESULTS: 'results',
  ISSUES: 'issues',
  FINISH: 'finish',
  NEWSLETTER: 'newsletter',
  REWARDS: 'rewards'
} as const;

这种写法会把对象的key、value都推导为固定字面量类型，没有开放通配索引，只要类型检查生效，访问BASE_ROUTES.foo这类未声明的属性会直接触发报错。

• 开启checkJs或添加@ts-check后，存量老JS代码的历史类型问题会一并暴露，可以临时用// @ts-ignore屏蔽无关的历史报错，逐步修复即可。
• 如果是在Nuxt/Vue的单文件组件<script>块里写JS代码，把// @ts-check加在<script>标签的第一行即可生效。
• 不要给枚举/常量对象手动加[key: string]: string这类通配索引签名，否则会直接失去未定义属性的校验能力，回到原问题的表现。

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