VSCode插件下载卡在“正在安装”或搜不到，根本原因是直连marketplace.visualstudio.com失败，应改用vscode.cdn.azure.cn镜像站手动下载.vsix文件后通过Extensions: Install from VSIX安装，并确保code命令已加入PATH且终端已重启。
VSCode插件下载卡在“正在安装”或根本搜不到、装不上，基本不是插件问题，而是网络或路径没对上——国内直连 Marketplace 几乎必慢，code --install-extension 命令又依赖 PATH 配置是否生效。
为什么在扩展面板里搜不到插件或安装失败
VSCode 内置扩展市场（marketplace.visualstudio.com）的请求走的是微软海外 CDN，国内多数地区 DNS 解析或连接会超时，表现为：搜索无结果、点击安装后进度条卡住、提示“Failed to fetch extensions”或直接空白。
- 不是插件下架了，是请求根本没发出去或没收到响应
- 不是 VSCode 版本太旧（1.60+ 基本都兼容），而是网络链路断了
- 重启 VSCode 无效，因为每次打开都会重试相同网络路径
用国内镜像下载 .vsix 文件再手动安装
这是目前最稳、最快、不依赖网络环境的方法，适合新手一次成功。关键不是“下载插件”，而是“拿到 .vsix 文件”。
- 打开国内镜像站：
https://vscode.cdn.azure.cn（微软官方授权 CDN，非第三方） - 在页面顶部搜索框输入插件名，比如
Chinese或Pylance - 点进插件页，找
Download Extension按钮，下载得到一个xxx-1.2.3.vsix文件 - 回到 VSCode，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Extensions: Install from VSIX - 选中刚下载的 .vsix 文件，确认即可——无需重启，中文包等插件立即生效
code --install-extension 命令不生效的三个硬条件
很多人复制教程命令 code --install-extension ms-python.python 却提示 command not found，不是命令错了，是环境没铺好。
- 安装 VSCode 时必须勾选
将 Code 添加到 PATH（Windows 安装向导第 4 步，“附加任务”里） - 勾选后需重启终端（CMD/PowerShell/Terminal），否则 PATH 不刷新
- macOS 用户若用 Homebrew 安装 VSCode，需额外运行
sudo xattr -rd com.apple.quarantine /Applications/Visual\ Studio\ Code.app解除隔离，否则命令调用会静默失败
离线环境怎么装插件（比如公司内网电脑）
核心逻辑是“两台机器分工”：一台能上网的下好 .vsix，另一台只负责导入。注意别直接复制插件文件夹，VSCode 不认。
- 能联网的机器：去
https://marketplace.visualstudio.com搜插件 → 点“Download Extension” → 得到 .vsix - 把 .vsix 文件拷到目标机器（U 盘、内网共享、邮件附件均可）
- 目标机器打开 VSCode →
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 选文件 - 如果提示“签名验证失败”，说明插件未签名或来源受限，此时需在设置里临时关闭：
extensions.autoCheckUpdates设为false，并确保extensions.ignoreRecommendations不干扰
真正卡住新手的从来不是“该装什么插件”，而是“怎么让第一个插件跑起来”。只要 .vsix 文件能下载下来、PATH 能被终端识别、VSCode 没被系统策略拦截，后面所有插件都是重复动作。别跳过安装时那个小小的勾选项，它决定了你之后要不要反复查 PATH。
