F2重命名枚举类型能否跨文件安全更新，取决于语言服务是否准确识别其声明、导出和使用方式；常见失效原因包括项目未以含tsconfig.json的目录为根、使用export default enum（非法）、仅通过export { Status }导出而声明无export、或调用方使用import * as等动态访问方式。
VSCode 重命名枚举类型（enum）本身是支持的，但能否跨文件、安全更新所有引用，完全取决于语言服务是否能准确识别该 enum 的声明位置、导出方式和使用方式——不是所有 enum 都能被 F2 正确处理。
为什么 F2 重命名 enum 有时只改了当前文件？
根本原因是语言服务器（LSP）没把你的 enum 当作可导出的“符号”来索引。常见情况包括：
-
enum定义在未被正确加载为项目根目录的文件中（比如打开单个.ts文件，而非包含tsconfig.json的文件夹） - 使用了
export default enum Status {...}—— TypeScript 不允许default修饰enum，实际会被降级为对象字面量，F2 失效 - 导出写法是
export { Status }，但声明时没加export（即先声明后导出），部分 LSP 版本无法反向追踪 - 调用方用了
import * as utils from './types'再访问utils.Status，这种动态属性访问不被语义重命名覆盖
确保重命名生效的三个硬性条件
必须同时满足，否则 F2 只做文本替换：
- 项目根目录存在
tsconfig.json（TS）或jsconfig.json（JS），且已启用"compilerOptions": { "composite": true }（大型项目推荐） -
enum声明必须带export关键字：export enum StatusCode { OK = 200 }，不能靠后续export { StatusCode } - 调用方使用具名导入：
import { StatusCode } from './types'；若用import types from './types'，重命名后types.StatusCode不会变
重命名后必须人工检查的 4 类地方
F2 永远不会触碰以下场景，漏掉一个就可能引发运行时错误：
-
obj[statusKey]或data['StatusCode']这类字符串键访问 - JSON Schema、YAML 配置、SQL 字符串中硬编码的枚举值名称（如
"status": "PENDING"） - 日志语句里的字符串：
console.log(`status is ${StatusCode.PENDING}`)中的PENDING不会被重命名影响，但如果你把枚举成员名从PENDING改成WAITING，日志里仍写的是旧字面量 - Vue/React 组件的
prop类型定义若写在 JSDoc 里（如/** @type {'PENDING' | 'DONE'} */），不属于 LSP 管理范围
Python 中重命名 enum 类的特殊限制
Python 的 Enum 类重命名更脆弱，因为 Pylance 默认不分析 from module import * 或 getattr() 调用：
- 必须用
from myenums import Status，不能用import myenums后写myenums.Status - 如果
Status在pyproject.toml根目录下未被 pyright 索引（比如 enum 文件在子包但没配置[tool.pyright]），重命名仅限本文件 -
IntEnum和StrEnum行为一致，但自定义__members__或动态生成成员的类，F2 会直接禁用重命名功能
最易被忽略的一点：重命名 enum 名称（如从 Status 改为 OrderStatus）时，VSCode 不会自动同步更新其所在文件名（status.ts → order-status.ts）——这需要手动操作或借助插件，而语言服务器对此毫无感知。
