现象

内网离线 VSCode 环境，Python 代码正常运行，但Ctrl+鼠标左键无法跳转函数/类定义、无代码追踪、无引用查找、Pylance 看似安装成功但不工作。

典型特征：Pylance未安装或者Pylance 已安装、无报错弹窗； 代码跳转定义完全失效；开发者控制台存在 Python 版本解析报错、Language Server 启动异常

以下为最终跑通、无兼容冲突、跳转完全正常的版本搭配：

• VSCode 版本：1.97.2

• Python 扩展（ms-python）：2026.2.2026021801（alpine-arm64 架构专用包）

• Pylance 版本：2025.2.102（预发行版）

⚠️ 注意点：新Python扩展 + 新版Pylance成对匹配，旧版2020/2019 Python扩展无论如何配置都存在底层解析BUG，导致跳转失效。

分析

错误方案「降级Pylance适配旧Python扩展」：

2019/2020 版本的ms-python 扩展存在底层版本解析BUG：

ValueError: The given version is not in the right format

该报错会直接导致 Pylance 语言服务启动失败、静默挂掉，表面看插件正常，实际索引、跳转、类型检查全部失效。

✅ 解决方案：升级新版 Python 扩展，与新版 Pylance 版本对齐，不要降级Pylance！

完整正确 settings.json 配置（离线内网专用）

文件路径：Preferences: Open Settings (JSON)

{ // 强制启用Pylance语言服务（解决跳转核心） "python.languageServer": "Pylance", // 内网关闭自动更新，避免后台阻塞启动 "python.autoUpdateLanguageServer": false, // 开启全局索引（函数跳转、查找引用必备） "python.analysis.indexing": true, // 关闭所有网络遥测，消除内网DNS报错干扰 "telemetry.telemetryLevel": "off" }

完整修复操作步骤（按顺序执行）

1. 彻底卸载老旧冲突扩展

卸载所有旧版本：ms-python 2019/2020 旧版和Pylance 2021 旧版

关闭 VSCode，清理全部缓存：

rm -rf ~/.vscode/extensions/ms-python*

2. 安装正确成对 VSIX 包（顺序不能反）

内网离线安装顺序：

先装 Python 扩展 → 再装 Pylance 扩展

1. ms-python.python-2026.2.2026021801@alpine-arm64.vsix

2. ms-python.vscode-pylance-2025.2.102.vsix

安装命令面板：Extensions: Install from VSIX...

3. 写入上面的 settings.json 并保存

确保强制锁定 Pylance 引擎、关闭自动更新、开启索引。

4. 清理项目本地缓存

进入项目目录执行：

rm -rf .vscode/.pylance

5. 重启 VSCode 等待索引完成

重启后观察右下角测试跳转，成功！。

最终效果验证

• 无任何 Pylance 版本兼容警告、无版本格式解析报错、Ctrl+左键 完美跳转