迁移至Linux时须统一用DIRECTORY_SEPARATOR拼接路径，.env路径读取后需转义，禁用硬编码分隔符，并用realpath()或SplFileInfo兜底标准化。
项目从 Windows 迁移到 Linux 服务器时，路径分隔符问题是最常见、最隐蔽的故障源头。不是所有代码都会立刻报错，但一旦涉及文件包含、日志写入、上传保存或配置加载，就可能静默失败或抛出“File not found”——而错误提示里根本看不出是分隔符惹的祸。
必须替换所有硬编码的反斜杠和正斜杠
Windows 下习惯写 'config\database.php' 或 'app/controllers/User.php'，这类写法在 Linux 上会直接失效（\ 被当作文本字符而非分隔符）。即使写 'config/database.php'，看似能跑通，但属于“侥幸兼容”，不满足路径标准化要求，后续做 explode('/', $path) 或 dirname() 处理时仍会出错。
- 全部改为用 DIRECTORY_SEPARATOR 拼接：
$path = 'config' . DIRECTORY_SEPARATOR . 'database.php'; - 涉及
__DIR__或dirname(__FILE__)的拼接，同样不能混用/：
✅ 正确：__DIR__ . DIRECTORY_SEPARATOR . 'lib' . DIRECTORY_SEPARATOR . 'Helper.php'
❌ 错误：__DIR__ . '/lib/Helper.php'（Windows 下生成混合路径如C:\project/lib/Helper.php）
.env 和外部配置中的路径要归一化处理
环境变量（如 UPLOAD_DIR=public/uploads）建议统一用正斜杠书写，便于 Git 管理和跨平台编辑。但读取后必须立即转为系统原生分隔符，否则拼接时混用会导致路径结构异常。
- 读取后马上替换：
$uploadPath = str_replace('/', DIRECTORY_SEPARATOR, $_ENV['UPLOAD_DIR']); - 再参与拼接：
$fullPath = $uploadPath . DIRECTORY_SEPARATOR . $filename; - 禁止在
.env中写UPLOAD_DIR=public\uploads—— Windows 编辑器可能自动转义，Git 行尾处理也可能破坏路径
别信“/ 在 Windows 也能用”的经验主义
虽然 include 'a/b.php' 在 Windows 下多数情况能工作，但以下场景会翻车：
立即学习“PHP免费学习笔记（深入）”；
-
glob('logs/*.log')：部分 SAPI 或扩展在 Windows 下对/解析不稳定 - 调用 shell 命令：
exec("cp {$src} {$dst}")，Linux shell 完全不识别\，而/在某些 Windows 命令行中又可能被误解析 - 路径拆分与判断：
substr($path, -1) === '/'在 Linux 下成立，在 Windows 下永远不成立 - 安全校验：
realpath()对含\的字符串在 Linux 下返回false，失去防护能力
用 realpath() 和 SplFileInfo 做最终兜底
手动拼接再严谨，也难覆盖 ../、重复分隔符、空段等边界情况。交给 PHP 内置解析器更可靠：
-
$abs = realpath('app/../config/database.php');→ 返回标准化绝对路径，自动归一化分隔符 -
$file = new SplFileInfo(__DIR__ . '/models/User.php'); echo $file->getPathname();→ 输出当前系统格式的完整路径 - 搭配
is_file()或is_dir()使用前，先过一遍realpath()，避免因路径未标准化导致误判
