PHP在Linux服务器执行报错而Windows正常，大概率是CRLF换行符导致解析失败；Linux下\r被识别为非法字符，引发Parse error；可通过PhpStorm检查状态栏或正则\r\n批量定位；一键设为LF并配置.gitattributes和.editorconfig可彻底解决。
PHP 文件在 Linux 服务器上执行报错，本地 Windows 开发却正常？大概率是 CRLF 换行符惹的祸——PHP 解析器在 Unix 环境下把 \r 当作非法字符，直接触发 Parse error: syntax error, unexpected '\r'。
为什么 CRLF 会导致 PHP 解析失败
PHP 脚本本质是文本文件，解析器按字节流读取。Windows 的 \r\n 中，\r（回车）在 Unix/Linux 系统中不是合法语句分隔符或空白字符，尤其出现在行尾、<?php 声明前、或字符串末尾时，会被识别为“意外字符”。常见错误信息就是：Parse error: syntax error, unexpected '\r' 或 Unexpected token "\r"（在 PHP 8.0+ 的 AST 解析中更敏感）。
这不是 PhpStorm 的 bug，而是跨平台换行标准不一致带来的真实兼容问题。Git 在 Windows 默认启用 core.autocrlf=true，会自动把 LF 转 CRLF 检出，但提交时又转回 LF——若项目没配 .gitattributes，协作中极易混入 CRLF。
- PHP 解析器只认
\n作为换行，\r出现在非预期位置即报错 - 错误常发生在第一行（
<?php \r）、?>\r闭合后、或 heredoc/nowdoc 边界 - 即使代码逻辑完全正确，CRLF 也能让整个脚本无法启动
如何快速定位哪些 PHP 文件含 CRLF
别靠肉眼检查。用 PhpStorm 自带的「文件属性」面板 + 全局搜索组合判断：
立即学习“PHP免费学习笔记（深入）”；
打开任意一个 PHP 文件 → 看编辑器右下角状态栏，显示 CRLF 还是 LF；若显示 CRLF，说明当前文件未标准化。
更高效的方式是批量扫描：
- 按
Ctrl+Shift+F（macOSCmd+Shift+F）打开全局搜索 - 搜索框输入正则：
\r\n（确保勾选Regex） - Scope 设为
Project Files，File mask 填*.php - 如果搜到结果，说明这些文件存在 CRLF —— 注意：仅匹配到
\r\n组合，不等于整文件都是 CRLF，但已足够预警
⚠️ 注意：不要用 ^\r$ 这类写法——它搜不到 \r\n，因为 \r 后面紧跟着 \n，不是行尾。
一键将整个项目 PHP 文件换行符统一为 LF
这是最常用、最安全的修复方式，无需手动逐个处理：
- 在 Project 视图中，右键点击项目根目录（或
src/、app/等关键目录） - 选择
File Properties → Line Separators → LF - 确认弹窗提示“Change line separators for N files”，点
Yes
该操作会修改所有被选中文件的实际内容（写入 \n 替代 \r\n），并自动触发保存。效果立竿见影，且不影响 Git 跟踪状态（只要没同时改代码逻辑）。
⚠️ 关键前提：确保你已配置 .gitattributes，否则下次在 Windows 上 git pull 可能又变回 CRLF。推荐在项目根目录加一行：
* text=auto eol=lf
或更精准地：
*.php text eol=lf *.js text eol=lf *.html text eol=lf
如何防止 CRLF 再次混入团队协作
光修一次不够。团队长期稳定依赖的是自动化约束：
- 在 PhpStorm 中关闭「自动转换换行符」：Settings → Editor → General → 取消勾选
Ensure line feed at file end on Save（这个选项和换行符类型无关，但开启后可能干扰判断） - 务必启用
.editorconfig支持，并在根目录添加.editorconfig文件，含以下内容：
root = true
<p>[*.{php,js,css,html,md}]
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = truePhpStorm 会自动读取并强制应用这些规则，新创建/保存的文件立即符合标准。
⚠️ 最容易被忽略的一点：Git 配置比编辑器配置更底层。即使 PhpStorm 设了 LF，若本地 Git 设置为 core.autocrlf=true（Windows 默认），检出时仍会转 CRLF。建议开发者统一执行：
git config --global core.autocrlf=input
（Linux/macOS 推荐）或
git config --global core.autocrlf=false
（Windows 上禁用自动转换，完全交由 .gitattributes 控制）。
