# Windows 上清理 Teams 缓存，先分清新版和经典版

Teams 在 Windows 上有两套缓存位置，删掉旧版的目录，并不会清掉新版客户端的缓存。动手之前先确认自己用的是哪个客户端，再分清是想清理出磁盘空间，还是重置出问题的本地应用，只清一小部分磁盘缓存，和把本地应用数据整个重置，丢掉的东西差得很远。

## 先选要处理哪一类数据

| 数据或现象 | 先做什么 | 会失去什么 |
| --- | --- | --- |
| 能重新生成的磁盘缓存 | 退出 Teams，只删除磁盘缓存的内容 | 缓存资源需要重新加载或编译 |
| 下载下来供离线使用的文档 | 单独检查保存的文件 | 本地副本，可能还有自己的修改 |
| 本地账号状态和设置 | 日常清理时保留 | 范围更大的重置可能需要重新登录和设置 |
| 本地客户端出问题 | 先尝试 Windows 的修复，再考虑重置 | 重置会删除应用数据和个性化设置 |
| 消息或频道缺失、未读数不对 | 先留着日志，交给管理员或支持人员看 | 清缓存修不好这类问题，还会把排查要用的日志一起清掉 |

微软的[缓存清理说明](https://learn.microsoft.com/en-us/troubleshoot/microsoftteams/teams-administration/clear-teams-cache)里写得很清楚，聊天和频道出现上面这些问题时，不要靠清缓存来处理，清完以后某个会话还是不对，也别反复清，先把现象记下来，办公电脑尤其如此，管理员排查时可能要用到这些诊断日志。

## 找到客户端和它的数据

用 **Win + R** 分别打开下面的位置，它们指向当前 Windows 用户，所以要在平时运行 Teams 的那个 Windows 账号里检查。

新版 Teams：

```text
%LOCALAPPDATA%\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams
```

经典版 Teams：

```text
%APPDATA%\Microsoft\Teams
```

微软说明里第一个位置用的是 `%userprofile%\appdata\local`，在标准的 Windows 用户目录里，它和 `%LOCALAPPDATA%` 是同一个地方。如果用户目录经过重定向，两者不一致，就按微软说明里的原始位置检查，不要猜另一个包名。

升级以后，两个目录可能都还在，但目录存在不代表对应客户端正在运行，经典版文件夹空了，也说明不了新版 Teams 的情况。微软只按新版和经典版分了两套步骤，没有按个人、工作或学校账号再分缓存路径，所以看电脑上装的是哪个客户端、目录实际在哪就行，账号类型说明不了什么，Teams Free 也不一定就是经典版目录。

## 应用出问题，先试修复入口

客户端出问题时，可以先试 [Windows 的修复选项](https://support.microsoft.com/en-us/windows/apps/repair-apps-and-programs-in-windows)，下面保留英文版 Windows 的菜单名称。Windows 11 打开 **Settings > Apps > Installed apps**，找到 **Microsoft Teams**，打开 **More** 菜单，再选 **Advanced options**。Windows 10 的入口是 **Settings > Apps > Apps & features**，选中 Teams，再打开 **Advanced options**。

如果有 **Repair**，先点它，再打开 Teams 看原来的问题还在不在。微软说明 [Repair 会保留应用数据](https://support.microsoft.com/en-us/accessibility/windows/use-a-screen-reader-to-explore-and-navigate-windows-app-support-tools)，它是用来修故障的，清理不出多少空间。有的电脑上看不到高级选项或修复按钮，找不到这个入口，也不等于可以去删别的 Microsoft 文件夹。

修复没解决，再在下面的局部清理和重置之间选择。两种操作之前都先完成手头的工作，把重要的下载文档另存到自己找得到的位置，重置之前还要确认能重新登录正确的账号，公司账号要求的身份验证也要能过。

## 只清能重新生成的磁盘缓存

先彻底退出 Teams，微软给的做法是在任务栏的 Teams 图标上选 **Quit**，只关掉窗口不算退出，有通话或会议就等结束了再弄。如果 Windows 提示文件正在使用，就停下来退出 Teams，不强行删除，也不要结束电脑上所有 WebView2 进程。

新版 Teams 打开上面的第一个位置，找到里面的 `EBWebView`，要清的只是它下面各配置文件夹里的 `Cache`、`Code Cache` 和 `GPUCache`。配置文件夹的名字可能不同，不要认定必须叫 `Default`，经典版要清的则是经典版目录下面直接的 `Cache` 和 `GPUCache`。

只删除这些缓存文件夹里的内容，文件夹本身保留，旁边的 `IndexedDB`、`Local Storage`、Cookie 和其他配置数据都留着。这个范围沿用 Mole 缓存目录的边界，比微软的整个目录清理步骤小，适合清理磁盘缓存，但不等于完整重置客户端，也不保证修好故障。

没有这些缓存子目录，就不要改删整个配置文件夹、`EBWebView`、`LocalCache` 或包目录，可能只是这台电脑上还没生成这几类缓存。手动删除时尽量放进回收站，留个恢复的余地，并看清确认提示，永久删除的内容从回收站是找不回来的。

## 确实需要微软的完整清理步骤时

微软给新版 Teams 写了两种范围更大的办法，一种是在 Windows 高级选项页点 **Reset**，然后重启 Teams，另一种是退出 Teams，打开上面那个新版 Teams 目录，删掉这个目录里面的所有文件和文件夹，再重启。经典版的步骤同样是退出后清掉经典版目录里的全部内容。

保留 `%APPDATA%\Microsoft`、整个包系列目录和其他应用的数据，Reset 明确会删除应用数据，包括个性化设置，清整个目录和 Reset 的影响都比只清几个缓存子目录大得多，很可能要重新登录，本地设置也不保证都能留住。

## 验证结果，下载文档另外看

清理前记下对应磁盘的可用空间，以及具体缓存文件夹的大小，清理后先别打开 Teams，再看一次同一块磁盘的可用空间，然后启动 Teams，试一下原来出问题的操作。第一次启动慢一些，是在重新生成缓存，后面容量有所增长也正常，不需要把缓存一直维持为空。

可用空间没变多，先看删掉的文件是不是还在回收站，没清空之前它们仍然占着原来的磁盘，确认用不着恢复之前先留着，别一遇到问题就清空整个回收站，另外也确认量的是自己实际在用的那个客户端，Teams 缓存本来就不大的话，可以按 [Windows 缓存清理](/zh/windows/blog/windows-cache-cleanup)接着找别的占用。

下载下来供离线使用的文件是另一回事，按微软的[下载说明](https://support.microsoft.com/en-us/teams/files/download-a-file-from-microsoft-teams)，英文版桌面 Teams 的下载位置在 **Settings and more > Settings > Files and links** 里的 **Downloads > Location > Change**，看一眼自己选的是哪里，文档不一定都在缓存里。修改位置只影响后续下载，已经存好的文件不会跟着搬过去。

工作或学校版 Teams 的[频道上传文件在 SharePoint，聊天上传文件在 OneDrive for Business](https://support.microsoft.com/en-us/teams/files/file-storage-in-microsoft-teams)，但下载后改过的本地副本不能因此随便删，尚未同步的工作要留着。完整清理以后如果需要重新登录，选对账号并完成验证，再恢复个人设置，原来的故障还在，就别再继续删了，带着留下的日志找管理员或支持人员。

## Mole 能做什么

Mole for Windows 的**清理**会列出新版 Teams 的 `EBWebView` 配置目录下的 `Cache`、`Code Cache` 和 `GPUCache`，以及经典版的 `Cache` 和 `GPUCache`。这些行默认勾选，Teams 正在运行时会被拦住，清理不会列出 `IndexedDB` 和 `Local Storage`，也不会重置整个 Teams 配置目录。普通缓存默认永久删除，想留个恢复的余地，就在清理前把**设置 > 缓存删除方式**改成**回收站**，这种局部清理也不等于微软的完整客户端重置。

## 常见问题

### 清缓存会删掉下载的文件吗？

上面这几个缓存文件夹不包括你选的下载位置，下载的文档要单独看，自己改过的和还要用的离线副本都留着，重置应用数据的范围就比只清缓存大了。

### 为什么 Teams 又开始下载数据？

删掉的资源下次用到时，Teams 会重新生成缓存，清得有没有用，要看原来的问题解决没有、可用空间有没有变多，不是看缓存能不能一直是空的。

### 清经典版目录能修复新版 Teams 吗？

不能，两个版本的数据在不同位置，要看的是新版 Teams 的包路径，无关的文件夹都留着，同一台电脑上两个客户端都留有数据时尤其要分清。


Canonical: https://mole.fit/zh/windows/blog/clear-teams-cache-windows
