PhpStorm 默认换行符按文件层级控制，新文件由 Editor > Code Style > Line Separators 设置（如选 Unix and macOS (\n)），但不修改已有文件；存量文件需手动转换或用 .gitattributes 统一规范。
PhpStorm 默认换行符在哪改
phpstorm 的默认换行符不是全局统一设置，而是按文件类型、项目、甚至单个文件分层控制。真正起作用的是 editor > code style > line separators 里的选项，但这里只影响新创建的文件——已有文件不会自动重写换行符。
常见错误现象：git status 显示一堆“文件已修改”，实际只是 CRLF 和 LF 差异；团队协作时 Windows 同事提交了 CRLF，Mac/Linux 同事拉下来后所有文件标红。
- 打开
Settings > Editor > Code Style > Line Separators - 选中
Line separator used for new files，下拉选Unix and macOS (\n)（即LF） - 这个设置不改变已存在文件，仅对新建文件生效
- 如果项目是跨平台协作，强烈建议统一用
LF—— Git 默认在 checkout 时把CRLF转成LF，但行为受core.autocrlf控制，容易混乱
怎么批量把现有文件换行符转成 LF
直接改设置不解决存量问题。必须主动转换，否则每次编辑都可能被 PhpStorm 自动“修正”回本地系统默认（比如 Windows 上默认是 CRLF）。
使用场景：刚接手一个混用换行符的旧项目，或团队决定统一用 LF 后需要清理历史文件。
- 菜单栏点
File > Line Separators > Convert Line Separators to Unix (\n) - 这个操作只对当前打开的文件有效，不能批量选多个文件执行
- 要批量处理整个项目？用
Ctrl + Shift + R（Windows/Linux）或Cmd + Shift + R（macOS）打开“Replace in Path”，勾选Regex，查找\r\n，替换为\n—— 但注意：这会改动文件内容本身，且无法逆向还原 - 更安全的做法是用命令行：
dos2unix -r -q **/*.php（需提前安装dos2unix），它只改行尾，不碰内容
为什么改了设置还是保存成 CRLF
因为 PhpStorm 尊重文件原始换行符。只要一个文件最初是 CRLF，哪怕你设置了默认用 LF，它也会继续用 CRLF 保存——这是为了防止意外破坏脚本（比如 #!/usr/bin/env php 开头的 PHP CLI 脚本在 Windows 上用 CRLF 可能出错）。
立即学习“PHP免费学习笔记（深入）”；
性能影响几乎为零，但兼容性风险真实存在：某些 Linux 容器、CI 环境、PHP-FPM 配置会因 CRLF 报错 Invalid argument 或解析失败。
- 检查当前文件实际用的换行符：右下角状态栏看
CRLF或LF标签，点击可切换 - 切换后保存，PhpStorm 会立刻重写整个文件（注意：Git 会标记为“已修改”，哪怕你只改了换行符）
- 如果右下角没显示换行符标识，去
Settings > Editor > General > Appearance勾选Show line separators - 别依赖“自动检测”，尤其当文件里混有
\r\n和\n（比如粘贴过 Windows 日志），PhpStorm 可能误判
Git 配合 PhpStorm 控制换行符更可靠
光靠 IDE 设置容易漏掉 CI 构建机、Docker 容器等环境。Git 的 .gitattributes 是唯一能跨工具、跨平台强制统一的方案。
使用场景：团队有 Win/Mac/Linux 混合开发，CI 运行在 Ubuntu 上，但有人本地用了 CRLF 提交。
- 项目根目录加
.gitattributes文件，内容写：* text=auto eol=lf
- 再加一行：
*.php text eol=lf
，确保 PHP 文件强制LF - 执行
git add --renormalize .让 Git 重新检出所有文件，按规则标准化换行符 - 之后 PhpStorm 打开文件时，右下角会显示
LF，且保存时不会擅自改成CRLF - 注意：
eol=lf不影响 Windows 用户编辑体验——Git 在 checkout 时转成CRLF（如果core.autocrlf=true），但 commit 时仍转回LF
最麻烦的点其实是历史提交里已经混入的 CRLF —— 它们不会被 .gitattributes 自动修复，得靠 git filter-repo 重写历史，代价高，慎用。
