__dir__始终指向定义它的文件所在目录，需与命名空间、文件系统协同；路径拼接统一用/再转分隔符；注意大小写、物理存在及路径重复；调试时以__file__为锚点。
在自动加载器中用 __DIR__ 拼路径，不是“写对就行”，而是要避开几个隐蔽但高频的失效点。关键不在常量本身，而在它和类名、命名空间、文件系统三者之间的配合逻辑。
别让 __DIR__ 变成“当前工作目录”的替身
__DIR__ 始终指向定义它的那个文件所在目录，不是自动加载器被调用时的脚本位置，更不是 getcwd() 返回的当前工作目录。自动加载器里如果写：
require __DIR__ . '/src/' . $class . '.php';
那这个 __DIR__ 就是自动加载器文件（比如 Autoloader.php）所在的目录，和你 new 的类在哪调用完全无关——这点必须确认清楚。
命名空间转路径时，/ 和 DIRECTORY_SEPARATOR 别混用
PHP 文件函数（include、require）能兼容正斜杠，但自动加载器常需做字符串处理（如 explode、str_replace），这时混用会出问题：
- ✅ 推荐：统一用 / 表示路径层级，拼接前再转分隔符
$path = str_replace('/', DIRECTORY_SEPARATOR, 'src/' . str_replace('\', '/', $class) . '.php'); - ❌ 避免：在 Windows 下手动拼 ，或在双引号里写 "src\$class.php"（反斜杠可能被解析为转义）
- ⚠️ 注意：__DIR__ 在 Windows 返回的是 ，直接拼 __DIR__ . 'src' . $class . '.php' 易错；改用 __DIR__ . '/src/' . $class . '.php' 更安全
类文件真实路径 ≠ 自动加载器计算出的路径
即使路径字符串拼对了，也得确保它真能定位到文件。常见断点：
- 检查大小写：Linux 下 User.php ≠ user.php，而类名 User 必须对应首字母大写的文件
- 验证物理存在：file_exists($fullPath) 要放在 require 前，失败时记录 $fullPath 和 realpath($fullPath) 对比，看是否因符号链接或 ../ 解析异常
- 避免路径重复：不要写 __DIR__ . '/src/' . '/Models/User.php'（开头多一个 /），用 rtrim(__DIR__, '/\') . '/src/' . $relPath 更稳妥
自动加载失败时，__FILE__ 是唯一可信的“锚点”
当类怎么都加载不到，别只查 $class 变量，立刻加一行调试：
- error_log('Autoloader running from: ' . __FILE__);
- error_log('Looking for class ' . $class . ' at: ' . $fullPath);
__FILE__ 不会被 include 链路影响，它永远告诉你“这行代码到底写在哪个物理文件里”，是排查路径基准偏移的第一依据。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
