Pylance未正确启用或配置会导致VSCode中Python代码补全缓慢、类型提示缺失、跳转定义失败；需依次确认安装启用、设置解释器路径、指定为默认语言服务器、查看日志、重置缓存并重启。
如果您在使用VSCode进行Python开发时发现代码补全缓慢、类型提示缺失或跳转定义失败，可能是Pylance未正确启用或配置。以下是针对该问题的多种排查与启用方法：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、确认Pylance扩展已安装并启用
Pylance作为独立扩展发布于VSCode Marketplace，需手动安装并确保处于启用状态，否则Python功能将回退至基础语言支持。
1、点击左侧活动栏的扩展图标（或按快捷键Ctrl+Shift+X）。
立即学习“Python免费学习笔记（深入）”；
2、在搜索框中输入Pylance，找到由Microsoft发布的官方扩展。
3、若右侧显示“已禁用”，点击“启用”按钮；若未安装，则点击“安装”。
二、设置Python解释器路径
Pylance依赖正确的Python解释器路径来解析项目依赖与类型信息，路径错误会导致类型推断失效或报错提示异常。
1、按下Cmd+Shift+P打开命令面板。
2、输入并选择Python: Select Interpreter。
3、从列表中选择一个已安装的Python环境（如venv、conda或系统Python），确保路径不为空且可访问。
三、检查工作区设置中Pylance是否设为默认语言服务器
VSCode允许为Python语言指定不同的语言服务器（如Jedi、Pylance、None），必须显式指定Pylance以启用其全部特性。
1、打开命令面板（Cmd+Shift+P），输入并选择Preferences: Open Settings (JSON)。
2、在settings.json中添加或修改以下键值对：
"python.defaultInterpreterPath": "/path/to/your/python",
"python.languageServer": "Pylance"
四、验证Pylance日志输出
通过查看Pylance后台日志，可快速识别初始化失败、模块加载异常或类型存根缺失等底层问题。
1、按下Cmd+Shift+P打开命令面板。
2、输入并选择Developer: Toggle Developer Tools，切换到Console标签页。
3、在终端中运行Python文件或触发补全操作，观察控制台中以[Pylance]开头的日志条目。
五、重置Pylance缓存并重启语言服务器
Pylance会在本地缓存类型存根和符号索引，缓存损坏可能导致功能间歇性失效，需手动清除后重建。
1、按下Cmd+Shift+P打开命令面板。
2、输入并选择Python: Restart Language Server。
3、若问题持续，关闭VSCode，前往用户目录下的~/Library/Caches/Microsoft/Python Language Server/，删除其中全部内容。
