ThinkPHP跨平台路径问题需用DIRECTORY_SEPARATOR拼接、pathinfo解析、realpath归一化及大小写严格匹配。优先调用框架路径方法，禁用硬编码斜杠与大小写敏感写法，确保Windows与Linux行为一致。
ThinkPHP在不同系统下路径行为不一致，核心在于Windows和Linux对路径分隔符、大小写、解析函数的处理逻辑不同。统一的关键不是“绕开差异”，而是用框架和PHP原生提供的跨平台机制主动适配。
用DIRECTORY_SEPARATOR代替硬编码斜杠
别写'app/controller/Index.php'或"config/db.php"这类含固定/或\的字符串。DS常量在ThinkPHP里恒为/，不能随系统切换，实际不可靠。
- 拼接路径时统一用
DIRECTORY_SEPARATOR：例如APP_PATH . 'controller' . DIRECTORY_SEPARATOR . 'Index.php' - 框架内部已封装好路径工具，优先调用
think\facade\App::getAppPath()、think\facade\Env::get('root_path')等方法，它们返回的路径天然兼容当前系统 - 避免手写
__DIR__ . '/../config/'，改用dirname(__DIR__) . DIRECTORY_SEPARATOR . 'config'
解析路径必须用pathinfo()，别依赖basename()或正则
Windows下basename('C:\data\file.txt')可能返回data\file.txt而非file.txt，造成严重误判。
- 取文件名和扩展名：用
pathinfo($path, PATHINFO_BASENAME)和pathinfo($path, PATHINFO_EXTENSION) - 取目录部分：用
pathinfo($path, PATHINFO_DIRNAME)，它能自动识别C:\a\b.txt和/home/a/b.txt两种格式 - 批量获取：直接
$parts = pathinfo($path)，比多次调用更高效，且对空路径、末尾斜杠等边界情况有明确定义
校验路径前先realpath()归一化
相对路径、..、符号链接在不同系统下展开结果可能不同，直接file_exists()易出错。
立即学习“PHP免费学习笔记（深入）”；
- 对任何用户输入或动态拼接的路径，先执行
$abs = realpath($path)；返回false说明路径无效，应立即中断 - 再用
is_file($abs)或is_dir($abs)确认类型，避免因符号链接或挂载点导致误判 - 若路径来自
$_GET['file']等外部输入，先basename()剥离路径仅留文件名，再拼到白名单根目录下，最后用realpath()比对是否越界
Linux部署前必须修复大小写硬编码
Windows能读indexcontroller.php，但Linux要求文件名与类名严格一致（如IndexController.php），否则spl_autoload失败。
- 控制器文件名必须与类名完全对应：类
app\controller\Admin\UserController→ 文件路径app/controller/Admin/UserController.php - 模板引用统一小写：
{include file="index/index"}，避免Index/Index类写法 - 禁用opcache.file_cache_only（Windows下易固化错误大小写）
- 所有
require/include改用App::getAppPath()拼接，不用./或../
