应统一使用 DIRECTORY_SEPARATOR 并规范路径处理：ThinkPHP 日志路径需用 realpath 规范化，避免硬拆 /、禁用用户可控文件名、Windows 下改用日期字符串轮转、Docker 中注意 uid/gid 匹配。
日志文件名里用 DIRECTORY_SEPARATOR 还是硬写 /
ThinkPHP 默认用 / 拼接日志路径，Windows 下会生成类似 runtime/log/2024/06/15/test.log 的结构——但 Windows 文件系统其实支持 /，问题不在路径分隔符本身，而在日志文件名生成逻辑里某些地方用了 str_replace 或 explode 硬拆 /，导致在 Windows 上解析日期目录出错。
真正要改的是日志驱动中构造子目录路径的那部分代码，比如 thinklogdriverFile 类里的 getLogName 方法。它把时间格式（如 Y/m/d）直接用于生成目录，但没考虑 Windows 对路径中斜杠的容忍度差异。
- 不要手动替换
/为：PHP 在 Windows 下能识别/，强行换反而破坏跨平台一致性 - 确保所有路径拼接都走
dirname+basename或pathinfo，而不是字符串分割 - 检查自定义日志处理器是否用了
preg_split('///', $path)这类写法——换成pathinfo($path, PATHINFO_DIRNAME)
file_put_contents 写日志时权限失败在 Windows 和 Linux 表现不同
Linux 下常见 Permission denied，Windows 下更常出现 failed to open stream: Invalid argument，根源往往是路径含非法字符或长度超限，而非权限本身。
ThinkPHP 日志默认用 file_put_contents($filename, $log, FILE_APPEND | LOCK_EX)，但 Windows 对长路径（>260 字符）和保留名（如 CON、AUX）敏感，而 Linux 不管这些。
立即学习“PHP免费学习笔记（深入）”；
- 避免在日志文件名里拼入用户可控内容（如请求 URI），防止出现
CON.log这种名字 - 用
realpath($filename)前置校验路径有效性，再写入；Windows 下可加\?前缀绕过路径长度限制（需 PHP 7.4+） - Linux 下注意 SELinux 或容器环境里
runtime目录挂载时没开exec权限，导致LOCK_EX失败
日志轮转（rotate）在 Windows 下失效的几个具体原因
ThinkPHP 的日志轮转靠判断文件修改时间 + 配置的 max_files 或 time_format，但 Windows 的文件时间精度只有 10ms，且 FAT32 分区不存纳秒时间戳，容易让多进程写入时判定“同一天”失败。
更隐蔽的问题是：Windows 下 filemtime 可能返回 0，尤其当文件刚创建还没刷新到磁盘时，ThinkPHP 就会跳过轮转逻辑。
- 不要依赖
filemtime做精确轮转，改用日期字符串比对（如date('Y-m-d')和日志文件名中的日期段） - 在 Windows 测试环境开启
fsync强制落盘（stream_set_write_buffer($fp, 0)），避免时间戳延迟 - 配置
type为single可规避多数轮转问题，适合开发机或 CI 环境
配置项 log.file 和 log.path 的跨平台写法
很多人以为只要把 log.path 设成 ./runtime/log 就够了，但 ThinkPHP 实际会用 Env::get('root_path') . $path 拼接，而 root_path 在 Windows 下可能带盘符（如 C:project），拼出来就是 C:project./runtime/log——大多数情况能用，但某些安全策略会拒绝这种混合路径。
正确做法是统一用绝对路径初始化，且显式调用 realpath 规范化。
- 在
config/log.php中写：'path' => realpath(__DIR__ . '/../runtime/log') . DIRECTORY_SEPARATOR - 避免在
log.file里写相对路径（如app.log），应写完整文件名（如app_' . date('Y-m-d') . '.log） - 如果用 Docker，确保
runtime目录挂载时 uid/gid 匹配容器内 PHP 进程用户，否则 Linux 容器里日志写入失败，Windows 主机上却正常
最麻烦的不是路径符号，而是 Windows 下文件句柄没释放干净、Linux 下 umask 影响日志权限、还有 Docker 卷挂载时的 inode 缓存问题——这些不会报明显错误，只会让日志偶尔消失或写错位置。
