DVC添加目录报错：路径重叠且对应.dvc文件不存在

问题分析 #

你遇到的报错根源是DVC本地状态中仍残留着project_model/data目录的追踪记录——尽管你已经删除了对应的.dvc文件，但DVC的状态索引未同步更新，导致它判定data/images和已标记追踪的data目录存在重叠。删除缓存和S3存储内容无法解决问题，因为问题出在本地的DVC状态记录，而非缓存数据本身。

解决步骤 #

1. 清理残留的DVC追踪记录
   先检查当前DVC追踪的所有项目：

   dvc list . --dvc-only
   

   如果输出中包含project_model/data，执行以下命令移除这个无效追踪项：

   dvc remove project_model/data
   

2. 重新添加目标目录
   清理完成后，重新执行添加命令：

   dvc add ./project_model/data/
   

   此时会正常生成project_model/data.dvc文件。

3. 提交并推送至远程存储
   按流程完成后续操作：

   dvc commit project_model/data.dvc
   dvc push -r dvcstore project_model/data.dvc
   

额外处理方案 #

如果执行dvc remove时提示目标不存在，可直接重置DVC本地状态：

dvc status --reset

之后再重新执行dvc add命令即可。

内容的提问来源于stack exchange，提问作者DanielBell99