Python 的重命名和 Extract Function 默认不可用，需安装启用 Pylance、配置 pyproject.toml/pyrightconfig.json 并确保状态栏显示“Python (Pylance)”；Extract Function 仅支持类内连续可执行语句，不支持模块级代码或含 return/注释/闭包变量的选区。
F2 重命名和 Extract Function 在 Python 项目里默认不可用，必须装 Pylance 并配好 pyproject.toml 或 pyrightconfig.json，否则光标停在变量上按 F2 会静默失败，右键也看不到重构菜单。
为什么 Python 的重命名总是没反应？
VSCode 不自带 Python 语义理解能力，F2 重命名依赖 Pylance 提供的 Language Server（LSP）。它不是“有 Python 扩展就行”，而是要满足三个硬条件：
- 已安装并启用
Pylance（不是仅装 Python 官方扩展） - 项目根目录存在
pyproject.toml或pyrightconfig.json，且配置了类型检查开关（如typeCheckingMode: basic） - 右下角状态栏显示
Python (Pylance)，而不是Python或Plain Text
常见现象：F2 按下后光标不动、无输入框；命令面板搜 Rename Symbol 显示 “No result”；右键菜单里 “Refactor” 灰掉。这基本等于 LSP 没加载成功——先打开开发者工具（Developer: Toggle Developer Tools），看 Console 是否报 No rename provider registered。
Extract Function 在 Python 中只支持类内方法提取
不同于 TypeScript，Pylance 当前（2026 年中）的 Extract Function 仅对类内部的代码块生效。选中顶层函数体、if 分支、或模块级表达式时，右键 → “Refactor” 不会出现该选项，快捷键 Ctrl+Shift+R 也搜不到。
立即学习“Python免费学习笔记（深入）”；
- ✅ 支持：在
class MyClass:内部选中几行逻辑，右键可触发Extract method - ❌ 不支持：在
.py文件顶部（类外）选中result = x * y + 1，无法提取 - ⚠️ 注意：即使支持，也要求选区是连续可执行语句——不能含
return（除非是方法末尾）、不能跨if/else分支、不能带注释或字符串字面量
替代方案：手动写 def new_func(x, y):，再用 F2 重命名函数名，比强求自动提取更可靠。
重命名漏改 import 或别名？检查 pyproject.toml 的 module resolution
Python 项目若用了 src/ 目录结构或自定义包路径（如 from myapp.utils import helper），重命名 helper 时可能只改当前文件，不改 import 行。这不是 bug，是 Pylance 默认按标准导入规则解析。
- 确保
pyproject.toml中启用了源码根声明，例如：[tool.pyright]<br>include = ["src/**"]<br>exclude = ["**/__pycache__", "**/node_modules"]
- 如果用了
setuptools风格的packages声明，Pylance 可能无法索引到子模块——加"src"到include最稳妥 - 重命名后 import 没变？运行命令面板里的
Developer: Restart Language Server，再试一次
另外，import xxx as yyy 中的 yyy 是别名，不属于符号重命名范围；只有原始模块/函数名（如 xxx.func_name）才会被 F2 覆盖。
参数名全是 arg0、arg1？别手敲，用 F2 接续重命名
Pylance 提取方法时推导参数名非常保守：它只认“被读取但未在选区内定义”的变量名。比如选中 print(user.name); return user.id，它会把 user 当作参数，但不会猜你想要 user_obj 还是 u，于是默认叫 arg0。
- 提取完成后，光标自动落在第一个参数上，立刻按
F2输入新名，回车即全局同步 - 想提前控制命名？在提取前，先把原变量重命名为有意义的名字（如把
u改成current_user），再选中操作 - 注意：Python 无类型标注时，参数和返回值都是
Any；加了def func(user: User) -> int:后，提取才带类型信息
真正容易被忽略的是：Pylance 的提取不处理闭包变量捕获。如果选中代码用了外层 nonlocal count 或 global flag，提取后的新方法不会自动带上这些上下文——得手动补 count 为参数，或检查副作用是否断裂。
