F2重命名只改当前文件，是因为语言服务未就绪：右下角语言模式须为JavaScript/TypeScript而非Plain Text，项目根目录需有jsconfig.json或tsconfig.json，且目标符号必须能通过F12跳转到定义。
为什么 F2 重命名有时只改当前文件？
因为 VSCode 的 F2 依赖语言服务的语义分析能力，不是简单字符串替换。如果项目没识别为 JavaScript/TypeScript 项目（比如没 jsconfig.json 或 tsconfig.json），或文件被识别为 Plain Text，它就退化成局部重命名。
- 检查右下角状态栏：必须显示
JavaScript或TypeScript，而不是Plain Text - 确保项目根目录有
jsconfig.json（哪怕空文件），否则跨文件引用无法解析 -
node_modules下的文件默认不参与重命名 —— 这是设计行为，不是 bug - 若重命名后只有当前文件变化，打开 Developer Tools（
Ctrl+Shift+I）看 Console 是否报No rename provider registered
Ctrl+Shift+R 按了没反应？先查这三个条件
Ctrl+Shift+R（macOS 是 Cmd+Shift+R）本身在默认配置里是未绑定的，按了没反应不是你手速问题，而是它根本没挂载命令。
- 打开快捷键面板（
Ctrl+K Ctrl+S），搜editor.action.refactor—— 如果状态是“未设置”，说明还没绑定 - 即使绑定了，也必须满足
when条件：editorHasCodeActionsProvider && editorTextFocus，缺一不可 - 光标必须落在可重构位置：函数名第一个字符、变量名首字母、或精确选中一段合法表达式（不能带分号，不能跨语句）
提取函数失败？大概率是选区语法不合法
VSCode 对“提取为函数”的选区要求比人眼判断更严格。它不是看你选了几行，而是看 AST 节点是否构成完整表达式或语句块。
- ✅ 可选：
a + b * c、getUser(id)、if (x) { return y } - ❌ 不可选：
const result = a + b;（带声明和分号）、return x; console.log(y);（多语句无包裹） - 选完后看编辑器左侧是否有黄色灯泡图标 —— 没灯泡=语言服务没提供该操作，不是快捷键问题
- Python 需 Pylance；JS/TS 建议配
jsconfig.json启用模块解析，否则跨文件提取可能失败
ESLint + Prettier 不是重构工具，但决定重构能否落地
它们不直接提供“提取”“重命名”功能，但会拦截不安全的重构结果，比如格式错乱导致语义变更、或违反规则的新命名。
-
eslint.enable: true开启后，重命名时若新名违反camelcase规则，会立刻标红 -
prettier.requireConfig: true+editor.formatOnSave: true确保提取函数后缩进、括号风格统一，避免 Git diff 里全是格式噪音 - 关键点：Prettier 不能修复语法错误 —— 如果重构后代码跑不起来，先关掉自动格式化，排查逻辑是否被意外破坏
重构真正卡住的地方，往往不在“怎么点菜单”，而在语言服务是否就绪、选区是否被 AST 接受、以及格式/规范工具是否悄悄否决了你的改动。这些细节不报错，但会让操作静默失效。
