---
title: 清除 Microsoft Teams 客户端缓存的操作指南
description: Teams 出现登录异常、界面卡顿或加载失败时，清除本地缓存常可恢复。本文面向企业 IT 运维，说明 Windows 与 macOS 的缓存清理步骤、风险控制、验证方式与回退建议，并强调操作前退出 Teams、备份目录及在测试环境验证。
url: "https://www.lanever.com/docs/%e6%b8%85%e9%99%a4-microsoft-teams-%e5%ae%a2%e6%88%b7%e7%ab%af%e7%bc%93%e5%ad%98%e7%9a%84%e6%93%8d%e4%bd%9c%e6%8c%87%e5%8d%97/"
updated: "2026-10-12"
category: Office365
---

# 清除 Microsoft Teams 客户端缓存的操作指南

> **参考来源与致谢**
>
>
>
> - **引用来源：**[清除 Teams 缓存 - Microsoft Teams](https://learn.microsoft.com/zh-cn/microsoftteams/troubleshoot/teams-administration/clear-teams-cache)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

Microsoft Teams 客户端在长期使用后，本地缓存可能损坏或与当前配置不一致，导致以下现象：登录状态异常、频道或聊天列表加载失败、界面卡顿、头像或文件预览不显示、更新后行为异常。此类问题在排除网络、账号权限与服务端故障后，可尝试清除客户端缓存。

清除缓存不会删除用户数据，聊天记录、文件与账号信息仍保存在服务端。但缓存重建期间，Teams 首次启动可能比平时更慢。

## 准备与风险

- 确认问题与缓存相关，而非服务端故障或网络策略限制。
- 操作前退出 Teams，避免文件占用导致删除不完整。
- 建议先在测试设备或非关键终端验证流程，再批量执行。
- 如需保留现场，可先备份缓存目录到临时位置，便于回退排查。
- 记录当前 Teams 版本与操作系统版本，便于后续对照官方文档。

> 不同 Teams 版本与操作系统的缓存路径可能存在差异，具体请查阅对应版本的官方文档。

## 处理步骤

### Windows

1. 右键任务栏中的 Teams 图标，选择“退出”。
2. 按 Windows 徽标键 + R 打开“运行”对话框。
3. 输入 `%appdata%MicrosoftTeams`，选择“确定”。
4. 删除该目录下的所有文件与文件夹。
5. 重新启动 Teams。

### macOS

1. 右键扩展坞中的 Teams 图标，选择“退出”，或按 Command + Q。
2. 打开“访达”，进入 `/Applications/Utilities`，双击“终端”。
3. 执行以下命令：

```
rm -r ~/Library/Application Support/Microsoft/Teams
```

1. 重新启动 Teams。

> 删除命令不可撤销。执行前请确认路径正确，并确保已完成必要备份。

## 验证方法

- Teams 能正常启动并完成登录。
- 聊天、频道、文件等模块可正常加载。
- 原先的异常现象不再复现。
- 如问题依旧，检查网络、代理、账号权限与服务状态，并参考官方文档进一步排查。

## 回退建议

- 若清除缓存后问题加重，可从备份目录恢复原缓存文件。
- 无备份时，可卸载并重新安装 Teams 客户端。
- 批量操作前保留一台未处理设备作为对照，便于判断问题来源。

## 常见问题

- **清除缓存会丢失聊天记录吗？**不会。用户数据保存在服务端，缓存仅为本机临时文件。
- **重启后为何变慢？**Teams 需重新生成缓存文件，首次启动耗时较长属正常现象。
- **删除目录时提示占用怎么办？**确认 Teams 及相关进程已完全退出，必要时重启设备后再操作。
- **macOS 命令报错路径不存在？**确认当前用户与 Teams 安装方式，路径可能因版本不同而变化。
