Mac上VS Code占几十GB空间的根源在用户数据、缓存和扩展，安全清理方法包括：一、卸载非必要插件；二、清空~/Library/Caches/com.microsoft.VSCode等缓存目录；三、按时间筛选删除废弃workspaceStorage子目录；四、清除~/.vscode/extensions下-cache及.tmp等残留；五、用--user-data-dir临时验证并选择性重置User目录。
如果您发现 Mac 上 VS Code 占用磁盘空间达到几十 GB，其根源几乎全部集中在用户数据目录、缓存文件夹与扩展插件中。这些内容默认堆叠于系统盘的隐藏路径下，长期积累后极易挤占大量空间。以下是多种安全、可逆、分层清理的方法：
一、卸载非必要扩展插件
扩展插件是 VS Code 体积膨胀的首要来源，尤其含本地语言服务器（如 rust-analyzer、pyright）、调试器或大型依赖包的插件，单个即可占用数百 MB 至数 GB 空间。已禁用的插件仍保留在磁盘中，不会自动卸载。
1、打开 VS Code，点击左侧活动栏中的 Extensions 图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 @installed，查看当前启用的所有插件。
3、逐个检查插件详情页中的 “Size” 显示值（部分版本可见），优先右键卸载体积大且长期未使用的插件，例如 C/C++、Java Extension Pack、Python 官方包等。
4、对已禁用但未卸载的插件，右键选择 Uninstall 而非仅 Disable。
二、手动清理缓存目录
VS Code 的缓存分为 Chromium 渲染层缓存、GPU 缓存、崩溃日志等，全部位于 macOS 用户库的 Caches 目录下。这些文件可安全删除，重启后将自动重建，不会影响配置或已安装扩展。
1、退出 VS Code 全部进程——包括菜单栏中的图标和 Dock 中残留的窗口。
2、打开 Finder，按 Cmd+Shift+G，粘贴并跳转至：~/Library/Caches/com.microsoft.VSCode。
3、选中该文件夹内所有内容（不包括文件夹本身），按 Cmd+Delete 彻底移入废纸篓。
4、重复步骤 2–3，清理以下路径：~/Library/Caches/com.microsoft.VSCode.ShipIt 和 ~/Library/Caches/com.apple.LaunchServices（后者需重置应用关联缓存）。
三、精简工作区索引快照（workspaceStorage）
VS Code 为每个打开过的工作区生成独立索引快照，存于 ~/Library/Application Support/Code/User/workspaceStorage 下。每个子目录对应一个工作区，常达几百 MB，但并非临时文件；全删将导致所有工作区历史搜索、调试状态、符号索引丢失。
1、前往上述路径，打开终端执行：ls -lt | head -n 20，按修改时间排序列出最近变更的子目录。
2、识别出超过 6 个月未访问的工作区对应子目录（名称为 UUID 格式，可通过文件夹内 workspace.json 查看路径备注）。
3、对确认废弃的工作区子目录，执行：rm -rf [UUID-folder-name]。
4、切勿删除 workspaceStorage 文件夹本身，也勿清空整个 User 目录。
四、清除扩展缓存与临时解压残留
扩展更新失败时，VS Code 会在 extensions 目录下生成带 -cache 后缀的半成品文件夹，例如 ms-python.python-2024.12.0-cache。这类文件夹无法被正常识别，却持续占用空间，且可能干扰后续更新。
1、关闭 VS Code 并确保无后台进程运行。
2、前往：~/.vscode/extensions/（注意是用户级扩展目录，非 Application Support 下路径）。
3、执行命令：find ~/.vscode/extensions -name "*-cache" -type d -print0 | xargs -0 rm -rf。
4、再次检查该目录下是否仍有名称含 .tmp、.download 或 .staging 的残留子目录，一并删除。
五、重置用户数据目录（隔离验证模式）
当无法定位具体大户，或怀疑配置/扩展缓存深度污染时，可使用 --user-data-dir 启动空白环境进行比对。该方法不删除任何现有文件，仅新建临时目录运行，用于判断问题是否源于当前用户数据。
1、确保 VS Code 已完全退出。
2、打开终端，执行：code --user-data-dir /tmp/vscode-clean-test --disable-extensions。
3、观察新窗口启动后内存与磁盘占用是否显著下降；若正常，说明原 ~/Library/Application Support/Code/User 存在异常缓存或损坏配置。
4、如确认需重置，可将原 User 文件夹重命名为 User.backup，再重启 VS Code 生成全新配置目录（原 settings.json、keybindings.json 等将不再加载）。
