VS Code需配置jsconfig.json或tsconfig.json并启用语言服务才能实现安全重命名和提取函数；F2无效常因语言服务未加载，Extract Function灰掉则因选区不满足可提取条件。
VS Code 本身不内置完整的重构引擎，但通过 JavaScript / TypeScript 语言服务 + ESLint + 合理配置，能实现接近 IDE 级别的安全重命名和提取函数能力——前提是项目用的是支持类型推导的语法（如 TS 或带 JSDoc 的 JS）。
为什么直接按 F2 重命名有时没反应或改不全？
VS Code 的重命名依赖语言服务器提供的符号定义与引用信息。如果项目没正确启用 typescript-language-server 或 JavaScript` 未开启 `jsconfig.json / tsconfig.json，rename 就会退化为纯文本替换，极容易出错。
- 确保根目录有
jsconfig.json（JS 项目）或tsconfig.json（TS 项目），哪怕内容只是{"compilerOptions": {"allowJs": true}} - 关闭
javascript.suggest.autoImports可能干扰重命名，建议保持默认开启 - 在非模块文件（无
import/export、无require）中，变量作用域可能被误判，重命名范围会异常缩小
安全重命名：如何确认改对了所有地方？
触发 F2 后，VS Code 会在编辑器顶部弹出重命名输入框，并高亮显示所有待修改位置（含导入路径、调用处、类型声明等）。关键不是“快”，而是“看全”：
- 务必拖动右侧滚动条，检查是否所有引用都被列出；若只看到 1–2 处，大概率是语言服务未加载成功
- 注意区分
const foo = ...和function foo() {...}—— 它们属于不同符号，重命名时不会联动 - 若重命名后出现
Cannot find name 'xxx'错误，先检查是否漏掉了import语句中的别名（如import { foo as bar } from './x'中的bar不会被自动更新）
提取函数（Extract Function）为什么经常灰掉？
Ctrl+Shift+P → Extract Function 命令仅在 TypeScript / JavaScript 语言模式下可用，且要求选中代码满足“可提取性”条件：
- 选区必须是完整表达式或语句块，不能跨函数边界或包含未闭合括号/花括号
- 不能包含
return（除非在函数体内且上下文明确）、break、continue等跳转语句 - 若选中代码引用了外层变量但未作为参数传入，VS Code 会拒绝提取（这是保护措施，不是 bug）
- 推荐先用
/* @ts-ignore */临时绕过类型报错再尝试提取，提取完成后再补参数和类型注解
真实项目中更可靠的替代方案
当 VS Code 内置功能卡住时，别硬刚。直接用 ESLint + @typescript-eslint/recommended-requiring-type-checking 规则配合 eslint --fix，或借助 jscodeshift 脚本做批量安全修改，比手动点菜单更可控。
比如提取函数后发现参数太多，又想内联回去？VS Code 没提供“Undo Extract”，但撤销（Ctrl+Z）依然有效——只要没关文件、没重启窗口。这点容易被忽略，但很关键。
