重构前必须确认已安装Pylance扩展且状态栏显示“Python”，否则editor.action.refactor等命令不生效；F2重命名、Ctrl+.快速修复、Ctrl+Shift+R重构菜单三大快捷键均依赖语义分析，需光标位于有效符号或选区且代码无语法错误。
重构前必须确认的两件事
VSCode 默认不自动启用 Python 重构功能，editor.action.refactor 命令是否生效，取决于两个硬性条件：
- 已安装
Pylance扩展（不是仅装 Python 扩展）——它提供语义分析和重构建议能力 - 当前文件被识别为 Python（右下角状态栏显示
Python，而非Plain Text或其他语言）
常见错误现象：按下快捷键后无反应、灯泡图标不出现、F2 重命名失败。90% 是因为没装 Pylance 或文件未正确识别为 Python。
最实用的三个重构快捷键及适用场景
不用记一堆组合键，日常够用的核心操作就这三个，按使用频率排序：
-
F2：光标停在变量/函数名上时，直接重命名。支持跨文件更新所有引用（需 Pylance 启用“Rename Symbol”功能） -
Ctrl+.：光标在有问题的代码行（如未定义变量、类型不匹配、可提取常量等）时触发“快速修复”，弹出具体重构建议（如“Extract to constant”） -
Ctrl+Shift+R：光标选中一段表达式或语句块后调用，列出所有可用重构项，包括“Extract to function”、“Extract to variable”、“Introduce parameter”等
注意：Ctrl+Shift+R 的 when 条件是 editorHasCodeActionsProvider && editorTextFocus，意味着必须有选中文本且编辑器处于焦点状态，否则命令不会响应。
立即学习“Python免费学习笔记（深入）”；
参数差异与上下文敏感行为
同一个快捷键在不同位置触发的效果完全不同，这是容易踩坑的地方：
-
F2在函数名上 → 重命名整个函数及所有调用；在函数内部变量上 → 只重命名该作用域内变量 -
Ctrl+.在requests.get(url)行 → 可能建议“Add type annotation”；在if x == True:行 → 会提示“Simplify boolean check”，并给出“Replace with ‘if x:’”选项 -
Ctrl+Shift+R选中单个字符串字面量 → 出现“Extract to constant”；选中带副作用的表达式（如os.path.join(a, b)）→ 才会出现“Extract to function”
重构建议不是凭空出现的，它依赖 Pylance 对 AST 的实时分析。如果代码存在语法错误（比如缺括号、冒号），大部分重构选项会直接消失。
为什么有些重构选项始终不出现
不是快捷键失效，而是 VSCode 的重构机制有明确限制：
- “Extract to function” 要求选中代码必须是合法的表达式或语句序列，不能跨缩进层级（比如不能同时选中 if 分支和其外层代码）
- “Introduce variable” 不支持对已有赋值语句右侧再次提取（如
x = a + b中选中a + b不会触发） - 重命名类成员（如
self.name）时，F2默认只改当前文件；要跨文件重命名，需确保项目有正确配置的pyproject.toml或setup.py，且 Pylance 已完成索引
真正影响重构可用性的，从来不是快捷键本身，而是代码结构是否满足语言服务器的推断前提——这点比记住组合键重要得多。
