thinkphp中ds常量恒为'/'，不随系统切换，跨平台路径拼接应统一用'/'而非directory_separator；配置中禁用''，绝对路径优先用__dir__动态生成，runtime目录须全小写并确保权限正确。
Windows和Linux下DS常量行为不一致
ThinkPHP默认用DS常量表示目录分隔符，但它的值在不同系统里是固定的：DS始终是/（因为TP源码里直接定义为'/'），不是\或/动态切换。所以别指望它自动适配Windows路径——它根本不会变成反斜杠。
常见错误现象：用APP_PATH.DS.'common'.DS.'config.php'拼路径，在Windows上写入文件或require时失败，报failed to open stream: No such file or directory，尤其当路径传给fopen、file_get_contents或第三方库时。
- 真正需要跨平台拼路径，优先用
str_replace('\', '/', $path)统一转正斜杠（PHP原生函数和大多数扩展都认/） - 若必须保留系统原生分隔符（比如调用cmd/powershell或某些Windows-only扩展），改用
DIRECTORY_SEPARATOR，它随系统返回\或/ - ThinkPHP 6+ 的
think acadeApp::getAppPath()等方法返回的路径已标准化为/结尾，直接拼接即可，无需再补DS
配置文件中硬编码\路径在Linux下直接报错
有人在config/app.php里写'log_path' => 'D:\www\tp6\runtime\log\'，本地Windows跑得通，一上Linux就卡在mkdir(): Invalid path或Permission denied——因为D:\www\...在Linux根本不存在，且\被当普通字符解析，导致路径错乱。
使用场景：日志路径、缓存路径、上传根目录等需在配置中声明的绝对/相对路径。
- 一律用
/代替\，哪怕在Windows开发环境也这么写（PHP完全支持/访问Windows路径） - 绝对路径优先用
__DIR__或ROOT_PATH动态拼，例如：__DIR__ . '/../runtime/log/' - 避免用
$_SERVER['DOCUMENT_ROOT']拼路径——它在CLI模式下为空，且Web服务器配置差异大，不可靠
thinkhelperStr::snake()等辅助函数与路径无关，别误用
看到“路径兼容”就去翻Str类，结果发现snake()、camel()这些只处理字符串格式，跟目录分隔符毫无关系。这类函数常被新手拿来“强行适配”，反而把路径名改成app_config_php这种无效字符串。
性能影响：无；但逻辑错误会导致后续require找不到文件，或路由匹配失败。
- 路径拼接只依赖字符串操作或
realpath()/dirname()等原生函数，别引入无关的字符串工具 - ThinkPHP的
thinkFile类内部已做/标准化，读写文件时直接传/分隔的路径即可 - 自定义命令行指令（如
php think make:controller）生成的路径，源码里用的是str_replace('\', '/', ...)，可参考其写法
部署时runtime目录权限 + 路径大小写引发的隐性故障
Linux对路径大小写敏感，而Windows不敏感。如果代码里写了Runtime（首字母大写），在Windows能加载runtime目录下的缓存，到了Linux就找不到——is_dir('Runtime')返回false，导致缓存全失效，甚至报Class not found。
常见错误现象：本地开发一切正常，上线后模板不渲染、配置不生效、路由404，查日志发现runtime目录没被创建或为空。
- 所有路径字符串统一小写，包括目录名、配置项键名（如
'runtime_path'）、define('RUNTIME_PATH', ...)里的值 - 确保
runtime目录存在且Web用户有写权限（Linux常用chown www-data:www-data runtime） - CI/CD脚本里别用
copy或xcopy同步目录——它们可能保留大小写不一致的副本，改用rsync -av --delete并确认目标端目录名全小写
最麻烦的不是路径写错，而是大小写混用+权限不足+缓存未清这三者叠加，问题会延迟暴露，排查时容易漏掉其中一个环节。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
