F2重命名和Extract Function失效主因是语言服务未启用或插件被禁用；需确认状态栏显示“TypeScript 5.5+”或“Python (Pylance)”、项目根目录存在tsconfig.json/jsconfig.json或pyproject.toml、光标停在符号声明处且选区满足AST合法性要求。
F2重命名和Extract Function失效，基本不是插件“坏了”，而是TypeScript或Pylance语言服务没起来，或者插件本身被VSCode主动禁用。
确认语言服务是否真在运行
右下角状态栏必须显示 TypeScript 5.5+ 或 Python (Pylance)，不能是 JavaScript（没配置）或 Plain Text（文件未识别）。
光标停在函数名上按 F2，如果只改当前文件、不预览跨文件引用，说明语义分析没启用。
打开 Ctrl+Shift+P → Developer: Toggle Developer Tools，看 Console 里有没有 Cannot connect to tsserver 或 Pylance initialization failed。
- TS/JS项目：根目录必须有
tsconfig.json或jsconfig.json（哪怕内容只是{"compilerOptions": {"allowJs": true}}） - Python项目：必须装
Pylance，且settings.json中明确设"python.languageServer": "Pylance"，并存在pyproject.toml或pyrightconfig.json - Vue/TSX项目：额外检查
"volar.autoInsertDotValue": false，否则格式化会破坏点语法，间接干扰重构
检查插件是否被VSCode自动禁用
VSCode更新后，插件因 package.json 中 "engines.vscode" 字段不匹配会被静默禁用——状态栏可能还显示“已启用”，但实际没加载。
打开 Ctrl+Shift+P → Extensions: Show Installed Extensions，右上角筛选器选 Disabled。如果目标插件（如 esbenp.prettier-vscode 或 ms-python.python）出现在这里，就是它了。
控制台里常能看到红字：Extension 'xxx' is not compatible with Code '1.102.3'。
- 优先尝试插件右下角
⋯ → Install Another Version…，选一个与你code --version匹配的历史版 - 若该选项灰显，需手动下载对应
.vsix文件，解压后修改package.json中的engines.vscode字段再重装 - Remote-SSH 类插件还要同步远端
~/.vscode-server版本，否则连接卡在Starting VS Code Server
Refactor菜单为空或Extract Function灰显的直接原因
这不是功能缺失，而是选区或语法结构不满足语言服务的提取前提。Extract Function 不分析逻辑，只校验 AST 是否合法：选中内容必须是连续可执行语句，不能跨 if 块边界、不能以 return 或 await 开头、JS/TS 中末尾带分号会直接拒绝。
Python 提取时若含未赋值的局部变量（如 count += 1 但前面没 count = 0），Pylance 推不出参数，也会灰显。
- JS/TS 中，确保选区不含 JSX 属性（如
className）、模板字符串内变量、或动态属性访问（obj[key]） - 提取后立刻检查：新函数是否丢掉
async？外层let变量是否被当参数传入？参数名是不是arg0？光标默认停在第一个参数上，按F2就能重命名 - 重命名必须把光标停在**声明处**（如
function foo()的foo上），停在调用处（foo()）只会做文本替换
兜底方案：当所有智能重构都失灵时
别反复试错，先花三秒确认状态栏语言服务标识；失效时用原生正则查找替代，比手动改快得多，也比乱装“Auto Refactor”插件靠谱。
例如批量修正驼峰转下划线：([a-z])([A-Z]) → $1_$2，勾选“全字匹配”和“正则模式”，作用范围设为整个文件夹。
但注意：不要对含 JSX 属性（如 onClick）的代码盲目运行，可能把合法 prop 名破坏成 on_Click；也不要对 eval 或模板引擎字符串里的变量名运行，那不是符号引用。
- 正则替换前先
Ctrl+Shift+F预览所有匹配项，确认无误再全部替换 - ESLint + Prettier 自动修复 ≠ 自动重构，它们顺序错了会互相覆盖；应先开 ESLint 自动修复，再开 Prettier 格式化，并禁用 ESLint 的格式类规则（用
eslint-config-prettier） - 真正难的不是怎么点鼠标，而是判断哪段逻辑能被安全拆出——工具不会警告“这段耦合太深”，它只认语法合法性和作用域可见性
