0

0

VSCode启动卡住不动解决_处理加载与初始化故障

幻影之瞳

幻影之瞳

发布时间:2026-01-10 17:32:02

|

116人浏览过

|

来源于php中文网

原创

VSCode启动卡顿主要由扩展阻塞、GPU兼容性差、同步服务延迟或渲染线程占用引起;应依次尝试禁用扩展、禁用GPU、关闭同步、切换默认主题,并用--prof-startup分析性能瓶颈。

vscode启动卡住不动解决_处理加载与初始化故障

VSCode 启动卡在“正在加载扩展”界面

这是最常见的一类卡顿,本质是某个扩展在激活阶段阻塞了主进程。VSCode 1.80+ 默认启用 extensionHost 沙箱,但部分旧扩展仍依赖同步初始化逻辑,尤其在读取大文件、调用未超时的网络请求或执行阻塞式 fs.readFileSync 时会直接挂起 UI。

  • 先尝试安全模式启动:code --disable-extensions(终端执行),若能正常打开,说明问题出在扩展
  • 逐个禁用最近安装或更新过的扩展,重点关注带 language-eslintprettiergitlens 前缀的扩展
  • 检查 ~/.vscode/extensions/ 下扩展目录的 package.json,确认其 activationEvents 是否包含过于宽泛的触发项(如 *onStartupFinished
  • 临时重命名可疑扩展文件夹(如 esbenp.prettier-vscode-9.10.3esbenp.prettier-vscode-9.10.3.bak),再重启验证

启动时卡在“正在初始化窗口”或黑屏无响应

这通常与渲染进程崩溃或 GPU 加速冲突有关,尤其在远程开发、多显示器切换或使用 Intel 核显的机器上高频出现。VSCode 渲染器基于 Electron,而 Electron 对某些显卡驱动兼容性较差。

  • 强制禁用 GPU:启动时加参数 code --disable-gpu --disable-gpu-compositing
  • 关闭硬件加速后仍卡住?尝试 code --disable-features=CalculateNativeWinOcclusion(Windows)或 code --disable-features=UseOzonePlatform(Linux)
  • 检查 ~/.config/Code/Cache(Linux/macOS)或 %APPDATA%\Code\Cache(Windows)是否被损坏,可临时重命名整个 Cache 文件夹让 VSCode 重建
  • 若使用 WSL2,确保已安装最新版 WSL 内核,并在 ~/.wslconfig 中添加:
    wsl.conf
    [gui]
    enabled=true
    

设置同步开启状态下启动极慢或卡死

当启用 Settings Sync 且存在大量自定义键位、片段或已安装扩展差异时,VSCode 会在启动早期拉取远程配置并比对本地状态,期间若 GitHub 或 VS Code 的同步服务响应延迟(尤其是国内网络环境),就会表现为长时间无响应。

Short AI
Short AI

AI短视频生成器,轻松创作爆款短视频!

下载
  • 临时关闭同步:Ctrl+Shift+P → 输入 Preferences: Turn Off Settings Sync,再重启
  • 检查同步日志:打开命令面板 → Developer: Toggle Developer Tools → 切换到 Console 标签页,搜索 syncgithub 相关报错
  • 手动清理同步元数据:删除 ~/.vscode/argv.json 中的 "sync" 字段,或清空 ~/.vscode/settingsSyncMachineId 文件
  • 不建议长期关闭同步,但可改用离线优先策略:在 settings.json 中设 "sync.autoDownload": false"sync.autoUpload": false,仅需时手动触发

插件或主题导致渲染线程阻塞(无报错但界面冻结)

某些主题(尤其是含大量 CSS 变量动态计算的)或文件图标插件(如 vscode-icons 在扫描超多文件夹时)会持续占用渲染线程,导致窗口无法响应鼠标和键盘。这类问题不会抛出错误,但开发者工具里能看到 Rendering 面板帧率骤降甚至为 0。

  • 切换为默认主题验证:Ctrl+Shift+PPreferences: Color Theme → 选 Default Dark+
  • 禁用所有图标插件,观察是否恢复;若确认是图标插件问题,可在 settings.json 中加:
    "vsicons.projectDetection.disableDetect": true,
    "vsicons.presets.foldersAllDefaultIcon": true
    
  • 检查是否存在自定义 workbench.colorCustomizations,过度嵌套的 CSS 变量引用(如 var(--vscode-editor-foreground, var(--vscode-foreground)))可能引发递归计算
  • 终极排查法:用 code --prof-startup 生成启动性能分析文件,用 Chrome 打开 chrome://tracing 导入查看耗时最长的调用栈
实际修复时,多数人卡在“以为是 VSCode 本身坏了”,反复重装却忽略扩展和同步机制的副作用。真正耗时的往往不是代码加载,而是某一个扩展在后台默默读取整个 node_modules 目录,或者同步服务在等待一个超时的 GitHub API 请求。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

408

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

532

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

309

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

css
css

css是层叠样式表,用来表现HTML或XML等文件样式的计算机语言,不仅可以静态地修饰网页,还可以配合各种脚本语言动态地对网页各元素进行格式化。php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

509

2023.06.15

css居中
css居中

css居中:1、通过“margin: 0 auto; text-align: center”实现水平居中;2、通过“display:flex”实现水平居中;3、通过“display:table-cell”和“margin-left”实现居中。本专题为大家提供css居中的相关的文章、下载、课程内容,供大家免费下载体验。

262

2023.07.27

css如何插入图片
css如何插入图片

cssCSS是层叠样式表(Cascading Style Sheets)的缩写。它是一种用于描述网页或应用程序外观和样式的标记语言。CSS可以控制网页的字体、颜色、布局、大小、背景、边框等方面,使得网页的外观更加美观和易于阅读。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

752

2023.07.28

css超出显示...
css超出显示...

在CSS中,当文本内容超出容器的宽度或高度时,可以使用省略号来表示被隐藏的文本内容。本专题为大家提供css超出显示...的相关文章,相关教程,供大家免费体验。

536

2023.08.01

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

78

2026.01.09

热门下载

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

精品课程

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

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.8万人学习

CSS教程
CSS教程

共754课时 | 18.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号