GitHub PR变更页出现大量“Empty file.”提示该如何避免？

根因排查 #

这类无实际修改的文件被误计入PR变更的情况，通常由三类配置或操作问题导致：

• 换行符配置不一致：Windows、macOS/Linux的默认换行符分别为CRLF、LF，若本地Git的core.autocrlf配置与项目统一规则不符，拉取main分支代码时Git会自动批量转换文件换行符，被识别为整行内容变更。
• 文件权限被误追踪：Git默认会记录文件的可执行权限变更，若本地修改过项目文件权限，或是RubyMine的文件权限处理逻辑与远端仓库不一致，也会触发无内容变更的文件被判定为修改。
• 分支更新操作不规范：更新PR分支时使用merge而非rebase，或是操作过程中出现未完全解决的隐性冲突，也可能导致大量文件被误计入提交变更。

永久规避方案 #

• 统一项目换行符规则：在项目根目录新增.gitattributes文件，全局配置换行符转换逻辑，避免不同设备的换行符差异触发误判，示例配置如下：

* text=auto
# 文本类文件统一使用LF换行符
*.rb text eol=lf
*.md text eol=lf
*.yml text eol=lf
# 二进制文件不做换行符转换
*.png binary
*.jpg binary
*.exe binary

配置完成后执行git rm --cached -r . && git reset --hard重置本地文件状态即可生效。

• 关闭文件权限追踪：执行命令git config core.fileMode false关闭Git对文件权限的变更追踪，若需要全局生效可添加--global参数。
• 规范分支更新操作：更新PR分支时优先选择rebase而非merge，在RubyMine中的操作路径为：右键项目 → 选择Git → 选择Rebase → 选择main作为基准分支，rebase完成后强制推送到个人远程分支即可，该操作不会生成额外合并提交，也不会触发无意义的文件变更统计。
• 同步IDE格式化规则：将项目的代码格式化配置（如Ruby缩进规则、换行规则）存入项目配置目录同步到远端，所有协作者统一使用同一套规则，避免IDE自动格式化触发大量无意义变更。

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