VS Code 启动仍为旧版本,主因是系统残留旧版启动入口、未彻底清理配置/扩展/缓存,或 Settings Sync 自动恢复过时设置。需依次检查二进制路径、清除三类本地数据、断网初始化同步,并刷新 macOS 应用注册表。

VS Code 启动还是旧版本?先查 code --version 和实际二进制路径
不是更新没成功,而是系统可能还挂着旧版的启动入口。macOS 上常见 /usr/local/bin/code 指向老版;Windows 常见开始菜单快捷方式仍指向旧安装目录(比如 C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code (旧)\Code.exe);Linux 则可能是 /usr/bin/code 软链接没更新。
实操建议:
- 终端运行
which code(macOS/Linux)或where code(Windows CMD),看输出路径是否对应新安装位置 - 运行
code --version,确认输出的版本号和你刚下载的安装包一致 - 如果版本对但界面仍是旧的,大概率是配置文件缓存了旧 UI 状态,不是二进制问题
卸载不等于删掉安装目录:必须清理三类残留
VS Code 的“卸载”操作(尤其 macOS 的拖拽删除、Windows 控制面板卸载)通常只删主程序,放任配置、扩展、缓存继续生效,重装后立刻还原成老样子。
实操建议——按顺序清这三处:
-
用户数据目录:这是核心。macOS 是
~/Library/Application Support/Code;Windows 是%APPDATA%\Code;Linux 是~/.config/Code。删掉整个Code文件夹(不是里面的子目录) -
扩展目录:虽然属于用户数据目录下,但常被单独备份误恢复。路径同上,子目录为
Extensions,直接删更稳妥 -
缓存与日志:macOS 删
~/Library/Caches/com.microsoft.VSCode;Windows 删%APPDATA%\Code\Cache和%APPDATA%\Code\logs;Linux 删~/.cache/Code
重装后依然“像旧版”?检查 settings.json 和同步设置冲突
即使清空了所有本地目录,如果你开了 Settings Sync(用 GitHub 或 Microsoft 账户同步),重装后第一秒就会把旧配置拉回来——包括已弃用的设置项、过时的主题、甚至错误的 "workbench.startupEditor": "none" 这类老写法。
实操建议:
- 首次启动新 VS Code 时,**立刻断网**,或在登录同步前先打开命令面板(
Ctrl+Shift+P/Cmd+Shift+P),执行Preferences: Open Settings (JSON),手动删掉整个settings.json内容,保存空文件 - 再启用同步,观察哪些设置被自动加回来;重点检查
"editor.fontFamily"、"workbench.colorTheme"、"extensions.ignoreRecommendations"是否有异常值 - 某些插件(如
vscode-icons)会在更新后强制重置图标主题,导致视觉“倒退”,可临时禁用该插件验证
macOS 上双击 Dock 图标仍启旧版?检查 LSHandlers 缓存
macOS 会缓存应用的文件关联和启动行为,哪怕你删了旧版 App、重装新版,Dock 图标右键 → “在访达中显示” 可能仍指向 Code-1.78.2.app 这类带版本号的老路径。
实操建议:
- 右键 Dock 中的 VS Code 图标 → “选项” → “在访达中显示”,确认路径是否为
/Applications/Visual Studio Code.app(无版本号) - 如果不是,删掉旧版 App,然后在终端运行:
lsregister -f /Applications/Visual\ Studio\ Code.app强制刷新注册表 - 重启 Dock:
killall Dock,再测试双击行为
配置文件清理比重装更耗时间,但漏掉任意一类残留,都会让“新装”变成“换皮旧版”。尤其 settings.json 和同步服务,最容易让人以为重装失败。











