VSCode Pylance重命名类属性无法跨文件同步，如何实现全工作区重命名？

算力阿峰

2026-6-14

全工作区跨文件重命名类属性（Pylance）

明确类型关联
在file2.py中，给MyClass的实例添加清晰的类型注解，让Pylance能准确识别实例所属类：
```
from file1 import MyClass

# 给实例加上类型标注
instance: MyClass = MyClass()
instance.account_value = 100
```
如果是通过函数返回实例，也要给函数添加返回类型注解：
```
def create_instance() -> MyClass:
    return MyClass()
```
在属性定义处触发重命名
不要在类方法内的self.account_value处按F2，直接定位到file1.py中类属性的定义行（比如class MyClass: account_value = 0里的account_value），按下F2触发重命名。此时Pylance会扫描全工作区所有关联的引用，包括file2.py中的instance.account_value。
检查Pylance配置
确保工作区settings.json中相关配置正确：
```
{
    "python.analysis.typeCheckingMode": "standard",
    "python.analysis.autoSearchPaths": true
}
```
typeCheckingMode设为standard或strict能让Pylance更精准地追踪类型关联；autoSearchPaths开启后会自动识别同一目录下的模块。
重启语言服务器
如果上述操作后仍不生效，打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），执行Python: Restart Language Server，清除Pylance的缓存后再尝试重命名。