如何配置Git/PhpStorm忽略CRLF换行符变更

核心Git配置调整 #

在现有core.autocrlf=true、core.safecrlf=false的基础上，添加以下配置来忽略纯换行符变更：

• core.fileMode=false：避免Git将文件权限差异误判为内容修改（备份文件常伴随权限变动，可能叠加问题）
• core.whitespace=cr-at-eol：告知Git忽略行尾的CR字符，适配本地CRLF、仓库LF的换行规则

执行命令完成配置：

git config core.fileMode false
git config core.whitespace cr-at-eol

PhpStorm同步设置 #

确保PhpStorm的行为与Git配置对齐：

• 打开File > Settings > Version Control > Git，确认Git可执行文件路径指向本地正确的Git程序
• 进入File > Settings > Editor > Code Style > General，在Line separators选项中选择System-dependent，让PhpStorm自动使用Windows系统的CRLF换行
• 关闭空白变更显示：进入File > Settings > Version Control > Commit，取消勾选Show diff with whitespace changes，PhpStorm将不再展示仅换行符的改动

批量修复已标记的假变更文件 #

针对已被标记为修改的大量文件，无需逐个执行git add，直接用以下命令批量处理：

git add --renormalize .

该命令会让Git重新对所有文件执行换行符转换，将本地LF格式文件转为CRLF，同时更新Git索引，执行后git status和PhpStorm的变更列表都会清除这些假变更标记。

长期预防方案 #

在项目根目录创建.gitattributes文件，添加以下内容：

* text=auto

这个配置让Git自动识别文本文件并统一处理换行符，比全局core.autocrlf更灵活，还能确保所有协作开发者的换行符处理规则一致，从根源减少跨平台换行符问题。

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