如何解决VSCode启动卡住不动问题

阿墨酱_8583

阿墨酱_8583

2026-10-19

166人浏览

原创

vscode启动卡住不动90%以上是扩展激活阻塞主线程;先执行code --disable-extensions验证,若秒开则必为扩展问题,再运行developer: show running extensions排查activation time超1000ms或状态为activating的插件。

如何解决vscode启动卡住不动问题

VSCode启动卡住不动,90%以上是扩展在激活阶段阻塞了主线程,不是配置错、也不是安装损坏——先用 code --disable-extensions 验证,能秒开就不用往下看了。

卡在“正在加载扩展”:扩展激活阻塞主线程

这是最常见场景,本质是某个扩展的 activate() 函数执行同步 I/O(比如 fs.readFileSync)、未设超时的网络请求,或依赖的子进程(如 Python、SSH)卡在 spawn 阶段。

  • 终端运行 code --disable-extensions,能正常启动 → 100% 是扩展问题
  • 启动后立刻按 Ctrl+Shift+P,输入并运行 Developer: Show Running Extensions,重点关注 Activation Time (ms) 超过 1000 或状态为 Activating 的扩展
  • 高频嫌疑扩展:ms-python.python(旧版会强制初始化环境)、gitlens(默认全仓库扫描)、ms-vscode.js-debug(无 JS 文件也拉调试服务)、Remote - SSH(连接失败时静默挂起)
  • 别急着卸载,先改配置:比如关掉 gitlens.advanced.caching.enabled,或给 python.defaultInterpreterPath 指定明确路径,避免自动探测

卡在“正在初始化窗口”或黑屏:GPU 渲染或沙盒冲突

尤其在 Intel 核显 + NVIDIA 独显切换的笔记本、远程桌面(RDP)、或 WSL2 环境下高发。VSCode 渲染器基于 Electron,某些驱动对 WebGL 初始化异常敏感,会导致整个渲染线程卡死。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • 临时验证:终端运行 code --disable-gpu,能进界面就说明是 GPU 加速问题
  • Windows 用户可追加 --disable-gpu-compositing;Linux 用户可试 --disable-features=UseOzonePlatform
  • 永久生效需编辑 argv.json(路径:%APPDATA%\Code\User\argv.json 或 ~/Library/Application Support/Code/User/argv.json),加入 "disable-gpu": true
  • 注意:--disable-gpu 不影响扩展功能,只是换条路跑;而 --disable-extensions 是绕过问题,不是解决

启动后空白欢迎页 / 无限加载:URI 解析失败或用户数据损坏

典型现象是控制台(Developer: Toggle Developer Tools → Console)刷出大量 Failed to fetch,但不是网络问题——是 VSCode 内部构造 vscode-file:// 或 vscode-webview:// 资源路径时出错,常因用户目录含中文、空格或 OneDrive 同步路径引起。

  • Windows 下路径如 C:\Users\张三\ 会直接导致 URI 构造失败,表现为欢迎页空白或侧栏不显示
  • 临时解决:启动时指定干净路径,如 code --user-data-dir="C:\vscode-data"(确保全英文、无空格、不在同步盘)
  • 更彻底:重命名整个用户数据目录(%APPDATA%\Code 或 ~/.config/Code),VSCode 会重建干净目录;扩展本体仍在 ~/.vscode/extensions,重启后手动启用即可
  • Linux 用户若报 libXss.so.1: cannot open shared object file,说明缺系统依赖,运行 sudo apt install libxss1(Ubuntu/Debian)或 sudo yum install libXScrnSaver(CentOS/RHEL)

CentOS 7 / RHEL 7 上完全打不开:glibc 版本硬性不兼容

VSCode 1.86+ 明确要求 GLIBC_2.28+,而 CentOS 7 自带 glibc 2.17,这是底层 ABI 级不兼容,任何配置都无效——不是 bug,是官方已放弃支持。

  • 终端启动时看到 /lib64/libc.so.6: version 'GLIBC_2.28' not found 就是这个原因
  • 不要尝试升级系统 glibc:会直接崩系统,得不偿失
  • 可行方案只有三个:降级 VSCode 到 1.85 及以前版本(仍支持 glibc 2.17)、用容器运行(如 docker run -it --rm -v $(pwd):/workspace -p 3000:3000 codercom/code-server)、或 换发行版(如 Ubuntu 22.04+)
  • 注意:压缩包解压版和 .rpm/.deb 包在该场景下表现一致,区别只在于安装方式

真正难排查的从来不是“哪个扩展卡住了”,而是“为什么它卡得没报错”——比如 Remote - SSH 连不上远端时 UI 线程直接挂起,控制台却一片安静;又比如 Codex 插件在多用户服务器上因 /tmp/codex-ipc 权限冲突失败,日志里只有一行 EACCES 而已。这些地方没日志、不弹窗、也不崩溃,纯靠经验盯住 Activation Time 和 code --status 输出才能揪出来。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode启动问题 vscode

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1375

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2912

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1989

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1727

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2607

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1838

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1262

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1116

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

494

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程