VSCode启动卡在转圈大概率是用户数据目录缓存损坏,需清理%APPDATA%\Code\Cache、CachedData、GPUCache及%LOCALAPPDATA%\Programs\Microsoft VS Code\Cache四个路径,切勿误删User、Extensions等配置目录。

VSCode 启动卡在转圈、无响应,大概率是用户数据目录损坏
不是安装包问题,也不是系统权限不足,而是 AppData\Roaming\Code 或 AppData\Local\Programs\Microsoft VS Code 下的缓存/扩展/状态文件出错。VSCode 每次启动会读取这些目录里的 Cache、CachedData、GPUCache 和 User 下的 settings.json、workspaceStorage 等,一旦其中某个文件写坏或锁死,就会卡住初始化流程。
实操建议如下:
- 先尝试用命令行加
--disable-extensions启动:code --disable-extensions,如果能打开,说明是某个扩展导致的——但此时仍需清理缓存,因为扩展只是“触发器”,根因常在缓存层 - 不要直接删整个
Code文件夹,否则会丢失所有设置和已登录账号;重点清理的是缓存子目录,而非User主目录 - 关闭所有 VSCode 进程(包括后台托盘进程),可在任务管理器里确认
Code.exe和Code Helper.exe是否完全退出
必须清理的 4 个缓存路径(Windows)
这些路径位于当前用户目录下,对应不同用途,缺一不可:
-
%APPDATA%\Code\Cache:HTTP 请求缓存(如 Marketplace 接口响应),损坏后会导致扩展市场打不开、启动时卡网络请求 -
%APPDATA%\Code\CachedData:语法高亮、语言服务器元数据缓存,损坏会引起编辑器卡顿、智能提示失效 -
%APPDATA%\Code\GPUCache:渲染加速缓存,尤其在开启硬件加速时易出错,删除后首次启动略慢,但可避免白屏/卡转圈 -
%LOCALAPPDATA%\Programs\Microsoft VS Code\Cache:主程序级二进制缓存,和 Electron 渲染进程强相关,不清理这个,有时即使清了 Roaming 目录也无效
注意:%APPDATA% 对应 C:\Users\AppData\Roaming,%LOCALAPPDATA% 对应 C:\Users\AppData\Local;路径中不要带空格或中文,否则命令行操作容易失败。
清理时别碰这 3 类文件,否则白忙活
很多人删完还是打不开,是因为误删了不该动的内容:
- 别删
%APPDATA%\Code\User整个文件夹——它存着settings.json、keybindings.json、已启用的扩展列表(extensions子目录除外,可删)、登录态 token(Machine下的id文件)。删了就得重配所有偏好 - 别删
%APPDATA%\Code\Extensions——这是已安装扩展本体,删了要重装;真正该清的是每个扩展子目录下的node_modules和out缓存(但更稳妥做法是先禁用再删) - 别删
%APPDATA%\Code\Local Storage——这里存着工作区历史、最近打开项目记录,删了不影响启动,但会丢掉导航便利性;若非要清,只删leveldb子目录里的临时文件即可
清理后仍卡住?检查 GPU 和沙盒策略
极少数情况,缓存清理无效,问题出在底层渲染或安全策略上:
- 用
code --disable-gpu启动,如果成功,说明显卡驱动或 GPU 进程崩溃——后续可在设置里关掉hardwareAcceleration,或更新显卡驱动 - 企业环境或某些杀毒软件会拦截
Code Helper (Renderer).exe的沙盒行为,表现为启动几秒后静默退出;可临时关闭实时防护,或把Code.exe和整个Code目录加白名单 - 如果用的是便携版(
vscode-portable),缓存路径在data\user-data\Cache,不是AppData,别找错地方
缓存路径本身不复杂,但 VSCode 启动链路上有 7 层以上状态校验,任何一层卡住都会表现为“转圈”。最省事的做法永远是:关干净、删对路、再试一次——而不是反复重装或改注册表。


















