code --install-extension超时因CLI不读settings.json,必须设环境变量VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn才走国内镜像源,且需彻底退出VSCode进程生效。

命令行安装插件(code --install-extension)默认不读 settings.json,必须靠环境变量 VSCODE_EXTENSIONS_MSA_URL 才能走国内镜像源。
为什么 code --install-extension 还是超时?
VSCode 的 CLI 工具(code 命令)启动时**完全不加载用户设置 JSON**,它只认环境变量。即使你已在 settings.json 里配好了 extensions.gallery.serviceUrl,对命令行也无效。
- 现象:执行
code --install-extension ms-python.python卡在pending或报ETIMEDOUT、getaddrinfo ENOTFOUND marketplace.visualstudio.com - 根源:CLI 默认直连境外 gallery 地址,没走任何本地配置
- 验证方法:终端运行
env | grep VSCODE_EXTENSIONS_MSA_URL,若无输出,说明变量未设
怎么设 VSCODE_EXTENSIONS_MSA_URL 环境变量
该变量值就是国内镜像的根地址,VSCode CLI 会自动拼接后续路径(如 /_apis/public/gallery)。必须用微软官方支持的 vscode.cdn.azure.cn,其他镜像可能返回 404 或缺失 publisher 数据。
- Linux/macOS(当前终端临时生效):
export VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn - Windows PowerShell(当前会话):
$env:VSCODE_EXTENSIONS_MSA_URL="https://vscode.cdn.azure.cn" - Windows CMD(当前会话):
set VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn - 永久生效需写入 shell 配置文件(如
~/.zshrc)或系统环境变量(Windows)
装完插件后语言包不生效?别漏这一步
命令行装的是插件本身,但 VSCode 的界面语言切换需要手动触发——即使已装好 ms-ceintl.vscode-language-pack-zh-hans,也得进命令面板(Ctrl+Shift+P)运行 Configure Display Language,再选 zh-cn 并重启。
- 常见错觉:看到“Extension installed”就以为汉化完成,其实只是下载安装完毕
- 如果命令面板里搜不到
Configure Display Language,说明插件没装成功,先检查环境变量是否生效、网络是否被代理劫持(如 Clash TUN 模式) - 某些插件(如 Python、C++)还会额外下载语言服务器二进制包,这部分不走 gallery 协议,
VSCODE_EXTENSIONS_MSA_URL对其无效
环境变量和 settings.json 是两套独立机制,CLI 只信前者;而 UI 界面里的插件市场只认后者。两者都得配全,且每次改完都得彻底退出所有 Code 进程——这点最容易被忽略,进程不杀干净,变量或配置都不会重载。


















