F2重命名需光标精准落在标识符起始处、项目配置tsconfig.json且文件已保存，否则易漏改或降级为文本替换；Extract Function须手动选中连续合法语句，避开注释、字符串、分号及跨边界内容。
重命名符号：F2 是默认，但别只依赖它
VSCode 对 TypeScript 项目默认启用语义化重命名，F2 是最直接的入口。光标停在函数、变量、接口名上按 F2，输入新名回车即可跨文件更新所有引用——前提是当前文件被正确识别为 .ts 或 .tsx，且项目根目录下有 tsconfig.json（否则语言服务可能降级为 JavaScript 模式，丢失类型作用域判断）。
容易踩的坑：
- 没保存文件就重命名：部分引用可能未被语言服务索引，导致漏改；务必先保存
- 重命名时出现红色波浪线：说明新名与已有符号冲突（比如同作用域内已存在同名变量），VSCode 不会强制覆盖，得手动调整
- 类中属性重命名后，构造函数参数没同步？检查是否启用了
"typescript.preferences.renameShorthandProperties": true（默认开启，但旧版配置可能关掉）
提取函数/常量：选中代码 + Ctrl+Shift+R 或灯泡图标
想把一段计算逻辑抽成函数，不是靠复制粘贴，而是用语言服务理解上下文后生成安全封装。Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（Mac）呼出重构菜单，选“提取到函数”；更常用的是选中表达式后点编辑器右上角的黄色灯泡图标（?），再选对应项。
关键细节：
- 选中内容必须是合法表达式或语句块（比如不能只选半个
if条件） - 提取范围可选：当前函数、当前类、当前文件——选错范围会导致作用域外无法访问新函数，VSCode 不会自动加
export - 返回类型推断依赖类型标注：如果原表达式含隐式
any，新函数签名可能不准确，建议提前补全类型或启用"typescript.preferences.includeAutomaticTypeAcquisition": true
组织导入和移动文件：重构常被忽略的“副作用”操作
Organize Imports 看似只是整理 import 语句，但它直接影响重构安全性。比如你刚把一个工具函数从 utils.ts 提取到新文件 mathHelpers.ts，VSCode 自动触发的 Organize Imports 会删掉旧路径、加上新路径，并按字母序重排——但前提是当前文件的 import 语句没被手动注释或格式破坏。
移动文件时要注意：
- 用“移动到新文件”重构（右键 → Refactor → Move to a new file）比手动剪切更可靠，它会自动更新所有 import 路径
- 如果项目用了路径别名（如
@/types），确保tsconfig.json中"baseUrl"和"paths"配置生效，否则移动后 import 路径可能变成相对路径且报错 - 移动后若提示 “Cannot find module”，不是插件问题，大概率是
tsconfig.json的"include"没覆盖新文件路径
快捷键自定义：别硬记，但得知道怎么查
VSCode 默认快捷键够用，但团队协作或个人习惯不同，常需调整。比如有人觉得 F2 容易误触，想改成 Ctrl+Alt+R；或者希望 Extract to Function 有独立快捷键。
操作路径很直接：
- 打开命令面板：
Ctrl+Shift+P→ 输入Preferences: Open Keyboard Shortcuts - 搜索关键词，如
rename、extract function、organize imports - 点击左侧加号添加新绑定，注意
when条件（例如editorTextFocus && editorHasRenameProvider才允许重命名）
真正容易被忽略的是：快捷键是否生效，取决于当前编辑器的语言模式（右下角显示 TypeScript 还是 Plain Text）。哪怕文件后缀是 .ts，如果 VSCode 没加载 TypeScript 语言服务（比如 node_modules/typescript 缺失或版本太旧），所有重构快捷键都会静默失效——此时灯泡图标也不出现，得先查输出面板里 TypeScript 标签页的报错。
