VSCode无内置定期自动维护缓存机制，所有“自动”需手动配置触发点、脚本及系统调度；依赖默认行为会导致workspaceStorage膨胀、终端延迟、跳转失灵等问题。
VSCode 没有内置的“定期自动维护缓存”机制，所有所谓“自动”，都得靠你手动搭触发点+脚本+系统级调度。指望它像操作系统一样定时自检清理，只会等到 workspaceStorage 占满 30 GB 才发现终端输入延迟、跳转失灵、插件灰显。
用 tasks.json + 保存钩子实现“每次保存就清 Python 缓存”
Python 项目改完 .py 文件却没生效？大概率是 __pycache__ 或 .pyc 没更新。VSCode 不管这个，但你可以让它在保存时顺手删掉：
- 项目根目录下创建
.vscode/tasks.json - 写入以下内容（注意
isBackground设为false，否则保存会卡住）：
{
"version": "2.0.0",
"tasks": [
{
"label": "clean-pyc",
"type": "shell",
"command": "find . -name \"__pycache__\" -type d -prune -exec rm -rf {} + 2>/dev/null; find . -name \"*.pyc\" -delete 2>/dev/null",
"group": "build",
"presentation": {
"echo": true,
"reveal": "never",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
},
"problemMatcher": []
}
]
}再在 .vscode/settings.json 里加一行：
"files.onSave": [ "workbench.action.terminal.clear", "task clean-pyc" ]
⚠️ 注意：files.onSave 是 VSCode 原生支持的数组，但只接受命令 ID，不支持直接调 shell；所以必须先注册 task，再通过 task xxx 触发。Windows 用户请把 find 换成 Get-ChildItem -Recurse -Include \"__pycache__\", \"*.pyc\" | Remove-Item -Recurse -Force，并确保 PowerShell 脚本执行策略允许（Set-ExecutionPolicy RemoteSigned -Scope CurrentUser）。
用 cron / Task Scheduler 定期清全局 Cache 和 GPUCache
Cache 和 GPUCache 不随退出释放，长期堆积会导致 UI 卡顿、右键响应慢、终端光标延迟。它们必须定期物理删除，且重启后自动重建——不丢配置、不伤插件。
- Linux/macOS：每天凌晨 3 点清
Cache和GPUCache
0 3 * * * rm -rf "$HOME/Library/Caches/com.microsoft.VSCode/Cache" "$HOME/Library/Caches/com.microsoft.VSCode/GPUCache" 2>/dev/null
- Windows：用任务计划程序新建基本任务，触发器设为“每天”，操作设为“启动程序”，程序填
powershell.exe，参数填：
-Command "Remove-Item -Path '$env:APPDATA\Code\Cache', '$env:APPDATA\Code\GPUCache' -Recurse -Force -ErrorAction SilentlyContinue"
⚠️ 关键点：必须确保 VSCode 已完全退出（无 Code.exe、Code Helper.exe、node.exe 进程），否则文件被锁，删了也释放不了磁盘空间。
用脚本批量清理 workspaceStorage 中的僵尸工作区
workspaceStorage 是 C 盘空间杀手，每个子目录对应一个打开过的工作区，名字是 GUID，看不出用途。但它有个可靠线索：修改时间 ≈ 最后一次打开该工作区的时间。
- PowerShell 一行命令找出 90 天没动过的前 5 个最大目录：
Get-ChildItem "$env:APPDATA\Code\WorkspaceStorage" -Directory | Where-Object {$_.LastWriteTime -lt (Get-Date).AddDays(-90)} | ForEach-Object { $s = (Get-ChildItem $_.FullName -Recurse -File | Measure-Object Length -Sum).Sum; [PSCustomObject]@{Name=$_.Name; SizeMB=[math]::Round($s/1MB,2); LastWrite=$_.LastWriteTime} } | Sort-Object SizeMB -Descending | Select-Object -First 5- 确认无误后，加
| ForEach-Object { Remove-Item $_.FullName -Recurse -Force }执行清理 - macOS/Linux 用户可用：
find ~/Library/Application\ Support/Code/WorkspaceStorage -maxdepth 1 -type d -mtime +90 -exec du -sh {} \; | sort -hr | head -5
⚠️ 删错不会丢 .vscode/settings.json，但首次重开该工作区时搜索和符号跳转会慢几秒——因为索引要重建。别怕，这是正常现象。
为什么“自动维护”总失败？三个最常被忽略的硬约束
不是脚本写得不对，而是环境没对齐：
- VSCode 进程没杀干净：Windows 任务管理器里漏掉
Code Helper (Renderer).exe，macOS 活动监视器漏掉Code Helper (GPU)，Linuxpkill -f code没覆盖子进程——缓存文件句柄一直被占，删了也白删 - Remote 开发开着：WSL/Dev Container 会把缓存写进
Remote子目录，定时脚本若只扫本地路径，等于没动真格 - 插件自己建 cache：比如
ms-python.python在extensions/ms-python.python-xxx/out/client/cache/下另起炉灶，这种得进插件目录手动清，或等它暴露配置项
真正能跑通的“自动维护”，永远是“触发时机明确 + 路径精准 + 进程清空彻底”三者缺一不可。少一个，就只是看起来在动，其实什么都没变。
