python插件安装失败90%非插件本身问题，而是网络、缓存、权限或激活链路中断所致；需按层排查：先确认扩展系统是否崩溃（命令面板输入extensions: show installed extensions无响应则需彻底杀进程并禁用扩展重启），再检查网络直连marketplace.visualstudio.com是否成功、是否残留.incomplete文件夹、是否架构匹配（如m1/m2需arm64包），最后验证激活状态——仅安装成功不等于功能生效，须打开.py文件并查看output面板日志。
Python 插件（ms-python.python）安装失败，90% 不是插件本身问题，而是网络、缓存、权限或激活链路中断导致的。直接重装 VS Code 没用，得按层排查。
Extensions: Show Installed Extensions 打不开或空白
这是最常被忽略的第一故障点：不是插件下不了，是 VS Code 的扩展系统已崩溃。命令面板输入 Extensions: Show Installed Extensions 后无响应、白屏、或报错 command 'workbench.extensions.action.showInstalledExtensions' not found，说明扩展宿主进程（extensionHost）已不可用。
- 必须完全退出 VS Code 进程——Windows 用任务管理器杀掉所有
Code.exe和Code Helper.exe；macOS 用活动监视器查Code和Code Helper (Renderer)；Linux 看code相关进程 - 重启时加
--disable-extensions参数启动：code --disable-extensions，再逐个启用关键插件（如 Python、Pylance），定位是否某个插件拖垮了 host - 检查
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows）下是否有残留的.incomplete文件夹，直接删掉
安装卡在 “Installing…” 或提示 Failed to fetch
VS Code 默认连 marketplace.visualstudio.com，国内直连常因 DNS 污染或 TLS 握手失败静默中断，表现为进度条不动、控制台出现 ERR Failed to fetch: https://marketplace.visualstudio.com/，而非明确超时。
- 别依赖系统代理——VS Code 不自动继承
HTTP_PROXY环境变量；手动配置http.proxy且设http.proxyStrictSSL: false会削弱证书校验，容易触发后续激活失败 - 换源更稳：在
settings.json中添加（注意末尾斜杠）："extensions.gallery.serviceUrl": "https://marketplace.visualstudio.com/_apis/public/gallery/"
- 临时禁用自动更新避免干扰：
"extensions.autoUpdate": false
- 验证网络是否真通：
curl -v https://marketplace.visualstudio.com，若卡在 TLS handshake 或返回 403，就是网络层被拦截
手动安装 .vsix 后 Python 功能不生效
插件显示“已安装”，但没语法高亮、IntelliSense 不工作、调试器启动失败——这说明安装成功了，但激活失败。常见于 Pylance 版本错配、LSP 服务器下载中断或工作区未加载。
- 必须打开一个文件夹（哪怕空文件夹），纯编辑器窗口（没 workspace）下拖 .vsix 或执行
Extensions: Install from VSIX会被静默忽略 - 安装后看 Output 面板 → 切换到
Python或Extension Host，搜failed to activate或Cannot find module 'vscode'—— 前者多因ms-python.pylance和ms-python.python版本不兼容，后者多因 VS Code 升级后缓存未重建 - 离线环境首次启用会尝试下载
pyright或debugpy，默认走外网；若没网络，需提前手动下载对应 LSP 包并配置python.defaultInterpreterPath和python.languageServer - 确认
Help → About显示的架构（x64 / arm64）与 .vsix 构建目标一致；M1/M2 Mac 上装 x64 插件会导致 native 模块加载失败
code --install-extension 报 “not compatible with Code”
这个错误只比对主版本号和架构，不看小版本，也不联网校验。它发生在安装瞬间，根源藏在 .vsix 内部的 package.json。
- 运行
code --version，取输出第一个小数点前的数字（如1.90.2→1.90） - 解压 .vsix（重命名为 .zip 即可），打开
extension/package.json，找"engines": {"vscode": "^1.88.0"}—— 表示最低要求 1.88.0，你用 1.87.x 就直接被拒 - 不要盲目改
^1.88.0成=1.88.0；先确认该插件是否真需新版 API，否则可能引发运行时崩溃 - ARM 设备上装错架构包时，错误日志里通常没有提示，只会静默跳过激活；用
unzip -l xxx.vsix | head查看顶层目录名是否含arm64字样
真正麻烦的不是装不上，而是装上了却没触发激活逻辑——比如插件监听了 onLanguage:python，但你没打开任何 .py 文件，它就一直“待机”。别只盯着安装状态栏，得去 Output 面板看真实日志。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
