VSCode启动卡顿主因是插件激活耗时、文件监视器性能瓶颈、远程开发连接延迟及用户数据缓存异常;应逐项排查禁用插件、配置watcherExclude、断开远程连接、清理extensionsCache/searchCache等缓存目录。

插件太多导致 VSCode 启动卡在“Activating Extensions”
VSCode 启动慢,80% 的情况是某个或某几个插件在启动时执行了耗时操作,尤其是那些监听 onStartupFinished、onLanguage:xxx 或直接在激活函数里做网络请求、文件扫描的插件。
实操建议:
- 启动时按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Developer: Show Running Extensions,看哪些插件长期显示“Activating…” - 禁用所有插件后重启,再逐个启用,观察启动时间变化;重点关注
GitLens、ESLint、Prettier、Remote - SSH、各类语言服务器(如Python、Java Extension Pack) - 对非核心插件,改用“按需激活”:在
settings.json中加"extensions.autoUpdate": false,并手动控制启用范围
工作区过大触发文件监视器(chokidar)性能瓶颈
VSCode 默认开启文件监视来支持搜索、Git 状态、自动保存等,但当工作区含大量 node_modules、dist、.git、logs 等目录时,chokidar 会持续扫描,拖慢启动和响应速度。
实操建议:
- 在工作区根目录的
.vscode/settings.json中配置"files.watcherExclude",例如:"files.watcherExclude": { "**/node_modules/**": true, "**/dist/**": true, "**/.git/**": true, "**/build/**": true } - macOS 用户若使用
fsevents后仍卡顿,可临时关闭:设"files.useExperimentalFileWatcher": false - 避免把整个磁盘根目录或用户主目录作为工作区打开——这不是“方便”,是给 VSCode 下达“全盘扫描”指令
远程开发(SSH / WSL)连接延迟掩盖本地启动问题
很多人以为“VSCode 启动慢”,实际是远程扩展(如 Remote - SSH)在连接远端时阻塞了 UI 线程,表现为“界面卡住几秒甚至十几秒”,但日志里看不到明显报错。
实操建议:
- 先断开远程连接,在纯本地窗口中测试启动速度,确认是否真为本地问题
- 若必须用远程,把
"remote.SSH.enableDynamicForwarding"设为false,并检查~/.ssh/config中是否有冗余的ProxyCommand或超时设置 - WSL 用户注意:不要把项目放在 Windows 文件系统(
/mnt/c/...)下开发,IO 延迟极高;应移至\wsl$Ubuntuhome...对应路径
用户数据目录损坏或索引异常(特别是 searchCache 和 extensionsCache)
VSCode 会在用户数据目录缓存扩展、搜索索引、符号表等。一旦这些缓存写入中断或版本升级不兼容,可能引发反复重建、CPU 占满、启动停滞。
实操建议:
- 不重装 VSCode,而是清理缓存:关掉所有 VSCode 窗口,删除以下目录(路径因系统而异):
~/.vscode/extensionsCache
- 启动时加
--disable-extensions参数验证是否为扩展缓存问题:code --disable-extensions . - 如果频繁出现,考虑把
user-data-dir指向 SSD 上的独立路径,避开 OneDrive / iCloud 同步目录——这些同步服务会锁文件、干扰 VSCode 缓存读写
真正影响启动速度的,往往不是单个大功能开关,而是多个小配置叠加后的隐式 IO 负载。比如一个插件 + 未排除的 node_modules + 远程配置里的冗余跳转 + 缓存目录在云盘里——它们各自看起来无害,合起来就让启动变成一场耐心测试。











