webstorm 不支持“数字自动转枚举”重构，因 rename 仅处理已声明符号，extract constant 不跨文件且不建枚举；需手动定义枚举、逐文件用 alt+enter 替换并确保 ts server 加载类型。
WebStorm 本身不提供“自动把数字转成枚举”的重构功能，必须手动创建枚举 + 手动替换 + 启用语义引用更新，否则会漏改或误改。
为什么不能直接用 Rename 或 Extract Constant
WebStorm 的 Rename 只作用于已声明的符号（如变量、函数名），对裸数字字面量（如 404、200）无感知；Extract Constant（Ctrl+Alt+C）虽能抽一个数字为常量，但它只处理当前选中的一处，不会跨文件、不识别语义关联（比如所有 404 都代表 HTTP_NOT_FOUND），更不会帮你建枚举类型或补全 switch 分支。
- 直接对
if (status === 404)按Shift+F6：无效，光标落在数字上不触发语义重构 - 用
Ctrl+R全局替404→HttpStatus.NOT_FOUND：可能误改'error_404.html'或1404这类非独立数字 - 在 TypeScript 中定义了
enum HttpStatus后，再对某处404用Alt+Enter→ “Replace with enum member”：仅限该行生效，且要求光标在数字上、文件语言识别为 TypeScript、TS Server 已加载类型定义
安全落地的三步实操流程
目标是让所有 404 被替换成 HttpStatus.NOT_FOUND，且调用处获得类型提示和编译检查。
-
第一步：手动定义枚举，放在共享位置（如
types/http.ts）：export enum HttpStatus {<br> OK = 200,<br> NOT_FOUND = 404,<br> INTERNAL_SERVER_ERROR = 500,<br>} -
第二步：逐个文件启用智能替换 —— 不要用全局文本替换。打开含魔术数字的文件，将光标停在目标数字（如
404）上，按Alt+Enter，选择Replace with enum member 'NOT_FOUND'（若未出现，说明 WebStorm 没识别到HttpStatus类型，需检查tsconfig.json是否包含该文件、是否启用了 TS 语言服务） -
第三步：确认 import 自动注入 —— WebStorm 会在首次替换时自动加
import { HttpStatus } from './types/http';，但只发生在当前文件。若其他文件已有同名导入路径冲突（如import { HttpStatus } from '../constants';），它不会合并或修正，需手动统一
容易被忽略的兼容性细节
这一步不做，后续类型检查和跳转会失效。
- TypeScript 项目中，如果枚举定义在
.d.ts声明文件里，WebStorm 默认不索引其成员用于Alt+Enter替换，必须确保该文件被tsconfig.json的include或files字段覆盖 - Vue SFC 的
<script setup></script>里，若404出现在模板字符串中（如`status: ${404}`），Alt+Enter不可用；必须先移出模板字符串，再操作 - React 组件中使用
switch(status) { case 404: ... }，WebStorm 不会自动补全default分支或提示遗漏枚举成员，需靠 ESLint 的default-case或 TS 的no-exhaustive-deps插件兜底 - 如果项目用了 Vite 别名（如
@/types），需在Settings > Languages & Frameworks > JavaScript > Webpack中填入vite.config.ts路径，否则 import 路径解析失败，Alt+Enter替换选项不显示
真正麻烦的不是替换动作本身，而是枚举定义后，所有历史代码是否都重新走了一遍类型推导——WebStorm 不会主动刷新整个项目的语义缓存，有时要手动 Ctrl+Shift+P → Restart TypeScript Server 才能让新枚举在所有文件里可被识别和替换。
