macOS上彻底卸载VSCode需删除五个核心路径:/Applications/Visual Studio Code.app、~/Library/Application Support/Code、~/Library/Caches/com.microsoft.code.ShipIt、~/Library/Logs/Code及~/.vscode,并清理Homebrew残留与权限问题,否则重装后设置、扩展、崩溃等问题将重现。

卸载 VSCode 前先确认是否真要「彻底」删干净
macOS 上的 VSCode 卸载不等于拖进废纸篓——Visual Studio Code.app 只是主程序,配置、缓存、扩展、用户数据全在别处。如果你只是想重装解决崩溃/插件冲突/设置错乱,不清理这些残留,重装后问题大概率重现。
常见误操作:直接删 /Applications/Visual Studio Code.app → 启动后发现主题、设置、已安装扩展全在,但某些功能异常(比如 Git 集成失效、终端乱码),其实是旧 settings.json 或损坏的 extensions/ 引起的。
- 用户配置路径:
~/Library/Application Support/Code - 缓存路径:
~/Library/Caches/com.microsoft.code.ShipIt(ShipIt 是自动更新器用的) - 扩展路径:
~/.vscode/extensions(注意是~/.vscode,不是~/Library/Application Support/Code/...) - 日志和崩溃报告:
~/Library/Logs/Code
执行彻底卸载:命令行比手动找更可靠
图形界面容易漏掉隐藏目录(比如 .vscode 在用户根目录下默认不可见),推荐用终端一次性清空。打开 Terminal,逐条运行:
rm -rf "/Applications/Visual Studio Code.app" rm -rf "$HOME/Library/Application Support/Code" rm -rf "$HOME/Library/Caches/com.microsoft.code.ShipIt" rm -rf "$HOME/Library/Logs/Code" rm -rf "$HOME/.vscode"
注意:$HOME/.vscode 和 $HOME/Library/Application Support/Code 存储内容不同——前者放全局扩展和部分用户级设置,后者存工作区历史、调试会话、密钥环等。两个都得删。
如果曾用 Homebrew 安装过(brew install --cask visualstudiocode),顺手补一句:
brew uninstall --cask visualstudiocode
否则下次 brew update && brew upgrade 可能又把它拉回来。
重新安装时避开签名验证失败和权限问题
从官网下载的 VSCode-darwin-universal.zip 解压后,双击运行常弹出「已损坏,无法打开」——这是 macOS Gatekeeper 对未公证(notarized)或刚下载 app 的拦截,不是文件坏了。
正确做法不是关掉系统安全性,而是用右键「打开」绕过首次校验;或者终端强制放开:
xattr -d com.apple.quarantine "/Applications/Visual Studio Code.app"
如果安装后启动报 Permission denied 或无法写入 settings.json,检查 ~/Library/Application Support/Code 是否残留(哪怕空文件夹),它可能被设为 root 所有者(尤其之前用 sudo 启动过)。运行:
sudo chown -R $(whoami) ~/Library/Application\ Support/Code
再启动就正常了。
重装后立刻验证的关键项
别急着导入旧设置——先确保基础功能跑通,再逐步恢复。重点验证三项:
- 终端集成:
Ctrl+`能否唤起内置终端?若不能,检查terminal.integrated.defaultProfile.osx是否被设成无效 shell(如旧版 zsh 路径) - Git 支持:打开任意 git 仓库,左下角应显示分支名;点开源代码管理面板,应列出变更文件。若提示
command 'git.status' not found,说明 PATH 没继承,需在 VSCode 设置里开启terminal.integrated.inheritEnv - 扩展激活:装一个轻量扩展(如
esbenp.prettier-vscode),新建.js文件,输入console.log(1)后按Cmd+Shift+P→Format Document,看是否生效
最后提醒:VSCode 的 settings.json 里若含绝对路径(比如指向某台旧机器的 Python 解释器),重装后这些路径大概率失效,建议先清空再按需重配,比硬修更省时间。


















