重装离线扩展插件必须先彻底清除残留状态、版本文件及依赖链，仅删gui再拖.vsix大概率静默失败；需关闭vscode、手动删除extensions目录下对应版本文件夹、同步重装所有extensiondependencies声明的依赖插件，并重启后通过output面板验证初始化日志确认成功。
重装离线扩展插件不是删了再拖一次就完事——多数失败源于残留状态未清、版本冲突或依赖链断裂。直接覆盖安装大概率静默失败，必须先拆解旧状态。
卸载前先确认插件是否真被禁用而非仅“显示已安装”
扩展面板里显示“已启用”不等于它在运行。语言类插件（如 ms-python.python）首次激活会尝试下载 pyright 或 debugpy 二进制，离线时卡住后 VSCode 会自动禁用整个扩展，但界面仍显示“已启用”。
- 按
Ctrl+Shift+P输入Developer: Show Running Extensions，看目标插件是否在列表中；不在即已被静默禁用 - 打开
Output面板（View → Output），下拉选择Python或Pylance，若看到Failed to fetch或spawn ENOENT，说明上次启动已失败 - 别信右下角“已启用”标签——那是 UI 缓存，不是真实状态
彻底卸载必须删文件，不能只靠 GUI 点“卸载”
VSCode 的 GUI 卸载按钮在离线/策略受限环境下常失效，它只改注册表或 JSON 标记，不删磁盘文件。残留的 node_modules 或旧版 package.json 会导致新 .vsix 安装时拒绝覆盖。
- 关掉 VSCode（包括托盘进程），否则文件被占用无法删除
- 定位扩展目录：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 找以
publisher.name-version命名的文件夹（如ms-python.python-2024.6.0），整文件夹删掉，不要只删里面内容 - 如果不确定哪些是目标插件，用命令行查：
code --list-extensions --show-versions | findstr python（Windows）或code --list-extensions --show-versions | grep python（macOS/Linux）
重装时必须避开三个静默失败点
拖 .vsix 进编辑区是最常用方式，但它对环境极其敏感，任一条件不满足就完全没反应，连错误提示都没有。
- VSCode 必须已加载工作区：哪怕只是
File → Open Folder…打开一个空文件夹，不能停留在初始欢迎页 - 窗口必须有系统焦点且非全屏：任务栏图标要高亮，远程桌面（RDP/TeamViewer）下拖放事件常被拦截
- 右下角状态栏不能显示
Extensions disabled by policy：这是组策略硬封锁，GUI 和 CLI 全无效，只能手动解压到extensions目录 - 拖的目标区域必须是主编辑区（白色代码区），拖到侧边栏、设置页、终端面板都无效
依赖插件必须同步重装，不能只换主包
像 ms-python.python 这类插件，核心功能（语法检查、调试）实际由 ms-python.vscode-pylance 和 ms-python.debugpy 提供。重装主包不等于重装依赖，旧依赖仍会尝试联网拉取二进制，导致再次卡死。
- 打开原
.vsix文件（用unzip -l xxx.vsix或 7-Zip），解压后查package.json中的extensionDependencies字段，列出所有依赖 ID - 去 Marketplace 页面对应插件的
Dependencies区域，确认每个依赖的版本号（如ms-python.vscode-pylance-2024.6.0） - 这些依赖的
.vsix必须和主插件同版本、同平台（win32-x64/darwin-arm64），否则加载时直接跳过 - 安装顺序无关紧要，但全部装完后必须重启 VSCode，否则依赖链不重建
最易被忽略的是：重装后不验证 Running Extensions 而只看面板，以及以为“拖进去弹了确认框=装成功”，其实那个弹窗只代表文件解析通过，不代表能加载。真正可用的唯一信号，是 Output 面板里对应通道出现初始化日志，比如 Pylance started 或 Python interpreter selected。
