PhpStorm怎么设置文件默认换行符_PhpStorm如何切换文件的行尾为LF或CRLF格式【方法】-phpstorm-PHP中文网

phpstorm 默认换行符按文件层级控制，新文件由 editor > code style > line separators 设置（如选 unix and macos (\n)），但不修改已有文件；存量文件需手动转换或用 .gitattributes 统一规范。

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 控制，容易混乱

直接改设置不解决存量问题。必须主动转换，否则每次编辑都可能被 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），它只改行尾，不碰内容

因为 PhpStorm 尊重文件原始换行符。只要一个文件最初是 CRLF，哪怕你设置了默认用 LF，它也会继续用 CRLF 保存——这是为了防止意外破坏脚本（比如 #!/usr/bin/env php 开头的 PHP CLI 脚本在 Windows 上用 CRLF 可能出错）。

性能影响几乎为零，但兼容性风险真实存在：某些 Linux 容器、CI 环境、PHP-FPM 配置会因 CRLF 报错 Invalid argument 或解析失败。

检查当前文件实际用的换行符：右下角状态栏看 CRLF 或 LF 标签，点击可切换
切换后保存，PhpStorm 会立刻重写整个文件（注意：Git 会标记为“已修改”，哪怕你只改了换行符）
如果右下角没显示换行符标识，去 Settings > Editor > General > Appearance 勾选 Show line separators
别依赖“自动检测”，尤其当文件里混有 \r\n 和 \n（比如粘贴过 Windows 日志），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