VSCode启动卡在“正在加载扩展”通常因默认联网检查更新或拉取语言服务导致,解决方法是:立即按Ctrl+Shift+P打开命令面板,编辑settings.json添加"update.mode": "none","extensions.autoCheckUpdates": false,保存后彻底退出并重启。

VSCode 启动后卡在“正在加载扩展”怎么办
离线启动 VSCode 时最典型的卡顿现象,就是右下角状态栏一直显示“正在加载扩展”,或弹出“检查更新失败”提示——这不是崩溃,而是它默认尝试联网拉取内置扩展(如 ms-vscode.vscode-typescript-next)或语言服务包。
必须在首次启动后立即干预,否则后续所有操作都会被后台重试拖慢:
- 按
Ctrl+Shift+P打开命令面板,输入Preferences: Open Settings (JSON) - 在打开的
settings.json中添加两行(注意逗号位置):"update.mode": "none",<br>"extensions.autoCheckUpdates": false
- 保存并彻底关闭 VSCode(包括右下角系统托盘进程),再重新打开
这两项禁用的是“自动行为”,不是功能本身;插件仍可手动启用,但不会反复超时阻塞主线程。
为什么双击 Code.exe 没反应,或启动后空白无界面
常见于使用非全量包(如 .zip 版或 User Installer)且未正确配置运行环境时。VSCode 不是绿色软件,缺运行时会静默退出。
关键判断点:先确认你用的是不是真正的全量包——只有 VSCodeSetup-x64.exe(System Installer)才自带 Electron 运行时、图标注册和 PATH 配置逻辑。
-
.zip版需手动解压后双击Code.exe,但不注册右键菜单、不写 PATH、不支持code命令 -
User Installer只写当前用户目录,若以不同权限启动(如管理员模式),可能找不到配置路径 - 启动空白页?检查是否误打开了远程连接页(Remote Explorer)、或工作区路径不存在导致初始化失败
稳妥做法:重装 VSCodeSetup-x64.exe,安装向导最后一页务必勾选「添加到 PATH」和「将“通过 Code 打开”添加到右键菜单」。
启动后终端里 node、git 命令报错,但系统 CMD 里正常
VSCode 内置终端默认不继承系统最新 PATH,尤其 Windows 上 MSI 安装的 Node.js 或 Git,PATH 可能只写入用户变量,而 VSCode 启动会话读取的是会话级环境变量。
不要依赖重启系统或反复改系统 PATH——直接在 VSCode 里配环境注入更稳:
- 打开设置(
Ctrl+,),搜索terminal.integrated.env.windows - 点击「在 settings.json 中编辑」,添加(路径按你实际安装位置调整):
"terminal.integrated.env.windows": {<br> "PATH": "C:\Program Files\nodejs;C:\Program Files\Git\bin;${env:PATH}"<br>} - 保存后,关闭所有已打开的终端面板,再新建一个终端测试
node -v和git --version
注意:反斜杠必须双写(\),且一定要保留 ${env:PATH},否则会丢失其他必要工具链路径。
插件显示已安装,但 Python 补全/格式化完全不触发
这是离线环境下最隐蔽的问题:插件前端(.vsix)装上了,但后端语言服务器(LSP)根本没落地。比如 ms-python.python 安装后首次打开 .py 文件,会尝试下载 pyright 或 python-language-server,离线就卡死在“Downloading Pylance…”。
解决方式不是重装 .vsix,而是预加载完整扩展目录:
- 在外网机器上,用同版本 VSCode 安装同一插件,并打开一个
.py文件,等状态栏显示 “Ready” - 找到该插件完整目录:
%USERPROFILE%AppDataRoamingCodeExtensionsms-python.python-2024.6.0(含out/、dist/、node_modules/和 native 二进制) - 整目录拷贝到内网机对应路径下,覆盖同名文件夹
- 彻底退出 VSCode(任务管理器中结束所有
Code.exe进程),再启动
ARM Mac 用户尤其注意:x64 构建的插件即使能装上,native 部分也会静默失效,必须匹配 darwin-arm64 构建版本。


















