vscode提取函数失败的根本原因是选区不满足“语法自包含”要求且语言服务器未正确启用：python需pylance并配置pyproject.toml，js/ts推荐glean替代原生功能，java依赖jdt.ls，所有重构均需验证语言服务器就绪状态。
VSCode提取函数失败？先看选区是否“语法自包含”
VSCode内置的Extract Function不是智能补全，而是语法包裹器：它只把选中内容原样塞进function或def里，不做逻辑校验。选区不合法，就直接报错或生成错误签名。
- 不能以
return开头（顶层return会被忽略，导致函数无返回值） - 不能跨缩进层级（比如选中
if块内两行 + 外层一行，会触发Cannot extract to function） - Python中不能含未初始化的变量（如
count += 1但前面没count = 0，Pylance推不出参数） - JS/TS中不能含
await却没标记async，否则生成的函数体不带async关键字
Python必须装Pylance，否则Extract Function基本不可用
只装官方Python插件，Ctrl+Shift+P → Extract Function大概率不出现——Jedi后端已退居备用，不支持语义级参数推导和跨文件引用分析。
- 确认
settings.json中设置了"python.languageServer": "Pylance" - 项目根目录必须有
pyproject.toml或pyrightconfig.json（哪怕为空文件，否则Pylance不启用完整语义分析） - 光标停在函数名上按
F2，若只改当前文件或提示Renaming 'xxx' is not available here，说明Pylance未就绪 - 右下角状态栏显示
Python≠语言服务器就绪，打开Developer: Toggle Developer Tools查Console是否有Pylance initialization failed
React项目优先用Glean，别依赖VSCode原生重构
VSCode对JSX/TSX的Extract Function仅处理纯JS逻辑，无法识别组件结构、props依赖或Hook调用链。选中一段JSX点提取，大概率报错或生成无效函数。
- 安装
Glean插件后，右键选中JSX →Extract Component，它会自动推断所需props、生成import、处理默认导出 - 对
useState变量重命名，Glean能同步更新setXXX函数名；原生F2只会改状态变量，漏掉setter - 类组件转函数组件、Hooks提取等操作，Glean提供专用命令，原生VSCode完全不支持
Java重构要靠JDT.LS，别信“右键就有”
VSCode Java重构能力取决于Language Support for Java™ by Red Hat插件背后的JDT Language Server（JDT.LS），不是编辑器自带功能。没装对插件或没激活，Refactor → Extract Method菜单根本不会出现。
- 确保已安装
Red Hat的Java插件，并重启VSCode - 打开
.java文件后，状态栏应显示Java (JDT.LS)，不是Java (Eclipse)或其他 - 提取方法时，选中代码必须是完整语句（如
int tax = base * 0.08;），不能只选base * 0.08表达式 - 跨文件重命名依赖JDT.LS索引，首次打开大项目需等待几秒“Building workspace”，否则F2只作用于当前文件
实际重构时最常被跳过的动作，是检查语言服务器是否真在工作——不是插件装了就行，得看状态栏、看F2行为、看Console日志。没这步，后面所有操作都在碰运气。
