Android Studio中deviceStreaming.xml是什么？如何让Git忽略它？

一、这个文件是什么？ #

• deviceStreaming.xml是Android Studio的设备流缓存文件，属于.idea/caches目录下的产物，用来记录和设备（包括模拟器）投屏、实时预览相关的临时状态数据——比如投屏窗口尺寸、连接状态、最近的设备会话信息等。
• 哪怕用同一模拟器，只要IDE检测到设备状态有细微变化（比如模拟器休眠唤醒、IDE后台重新连接设备），就会触发这个文件更新，所以会每隔几小时自动变更。

二、让Git彻底忽略它的方法 #

1. 问题根源 #

如果已经在.gitignore里加了.idea/但文件还能被追踪，核心原因是这个文件之前已经被Git纳入版本控制了——Git的ignore规则只对未被追踪的文件生效。

2. 具体操作步骤 #

• 第一步：从Git已追踪列表中移除该文件（不会删除本地文件）
  在项目根目录的终端执行命令：

  git rm --cached .idea/caches/deviceStreaming.xml
  

  要是想一次性彻底移除整个.idea目录的追踪记录（更推荐，因为.idea下大多是IDE本地配置），可以用：

  git rm --cached -r .idea
  

• 第二步：确认.gitignore规则正确
  打开项目根目录的.gitignore文件，确保包含以下规则（没有的话就加上）：

  # Android Studio IDE本地文件
  .idea/
  

• 第三步：提交变更
  执行命令提交.gitignore和移除追踪的修改：

  git add .gitignore
  git commit -m "停止追踪.idea目录并更新gitignore规则"
  

3. 额外提示 #

• 如果团队需要共享部分IDE配置（比如runConfigurations、modules.xml），可以修改.gitignore规则，只忽略缓存和本地专属配置：

  # .idea忽略规则（保留共享配置）
  .idea/caches/
  .idea/libraries/
  .idea/workspace.xml
  .idea/deviceStreaming.xml
  

• 执行git rm --cached后，本地文件不会被删除，只是Git不再追踪它的后续变更，不用担心本地配置丢失。

内容的提问来源于stack exchange，提问作者A.G.