JetBrains Rider 2026.1 Help

用于 Unity 的预提交检查

在 Unity 项目中,预提交检查通过在常见问题输入版本控制之前,确保仓库更加整洁和稳定。 本页将介绍两项主要预提交检查:检测 Unity 中的未保存更改以及识别带有 .meta 文件的空文件夹。

未保存更改检查

提交时,Rider 会与 Unity 通信以验证是否存在未保存的更改。 如果检测到更改,Rider 会通过对话框提示用户。

为何重要

此检查可防止 Unity 中未保存更改导致的问题影响从仓库拉取的团队成员。 未保存的更改可能包括已修改的场景和可编程对象。

运作方式

尝试提交时,Rider 会向 Unity 查询是否有未保存的修改。 如果 Unity 报告有未保存更改,Rider 会显示对话框,提醒用户在继续前保存工作。

带有 .meta 文件的空文件夹检查

Unity 会为每个新文件夹自动生成一个 .meta 文件,即使该文件夹为空。 此检查会在提交时检测带有 .meta 文件的空文件夹,并通过警告提示用户。

为何重要

Git 不会跟踪空文件夹,但会跟踪 .meta 文件。 如果提交了没有对应文件夹的 .meta 文件,Unity 会在没有该文件夹的其他机器上将其删除,从而导致在版本控制中不断添加和移除该文件的不必要循环。 这样会产生“提交乒乓”,即空文件夹的 .meta 文件在多次提交中不断被添加和移除,导致提交历史变得混乱。

运作方式

在完成提交前,Rider 会扫描是否存在对应空文件夹的 .meta 文件。 如发现此类文件,Rider 会提醒用户,用户可选择继续提交或取消并手动解决问题。

2026年 5月 8日