
禁用 VSCode 中 PyLance 跳转到 .pyi 文件
PyLance 扩展增强了 VS Code 的 Python 代码分析能力,但其默认行为会跳转至 .pyi 文件而非原始 .py 文件,影响代码阅读体验。 以下步骤可禁用此行为:
- 打开 VS Code 设置 (通常是
Ctrl + ,或点击文件菜单中的设置)。 - 在搜索栏输入 "PyLance"。
- 找到 "pylance.gotoSymbol" 设置项。
- 将其值修改为
"py"。
此设置强制 PyLance 优先跳转到 .py 文件。
关于 .pyi 文件
.pyi 文件是 Python 接口文件,包含模块和类的类型信息,用于 PyLance 提供精准的代码补全和类型提示。 即使 .py 文件未显式定义,PyLance 也可能通过以下方式生成 .pyi 文件:
-
动态类: PyLance 可为动态生成的类创建
.pyi文件。这些类的方法也可能动态生成,不在.py文件中定义。 -
动态方法: 使用
@property或@classmethod装饰器生成的动态方法,也可能导致.pyi文件的生成。
通过以上设置,您可以优化 PyLance 的跳转行为,提升代码浏览效率。










