include找不到同目录config.php是因为默认按include_path和getcwd()查找，而非__DIR__；应统一用__DIR__拼接绝对路径，如include DIR . '/config.php'，并注意斜杠、空格及include_path配置。
include 为什么连同目录的 config.php 都找不到
因为 include 默认不从当前脚本所在目录（__DIR__）查起，而是先查 include_path 设置的路径，再 fallback 到当前工作目录（getcwd()），而这两个都可能和你的直觉不符。
常见表现：
- 你在
/var/www/project/lib/db.php里写include 'config.php'，但config.php就在同目录，却报failed to open stream: No such file or directory - 命令行运行
php lib/db.php成功，浏览器访问http://localhost/lib/db.php却失败
根本原因：PHP 的工作目录（getcwd()）通常是 Web 服务器启动时的目录（如 /var/www 或 /），不是你脚本所在的目录。所以相对路径 'config.php' 实际被解释为 /var/www/config.php，而不是 /var/www/project/lib/config.php。
__DIR__ 是唯一靠谱的锚点，但用错就白搭
__DIR__ 返回的是当前 PHP 文件所在的绝对路径，它稳定、不随执行方式变化，是解决路径问题的基石。但很多人只改了写法，没注意拼接细节。
立即学习“PHP免费学习笔记（深入）”；
正确做法：
- ✅
include __DIR__ . '/config.php';—— 同级文件 - ✅
include __DIR__ . '/../config.php';—— 上级目录 - ✅
include __DIR__ . '/../../shared/init.php';—— 多层向上，斜杠统一用/
容易踩的坑：
- ❌
include __DIR__ . '\config.php';—— Windows 下反斜杠在双引号中可能被转义，一律用正斜杠 - ❌
include __DIR__ . '/config.php ';—— 末尾空格导致路径无效，肉眼难发现 - ❌ 在
include之后才定义常量或调用set_include_path()—— 路径已解析完毕，补救无效
set_include_path() 追加路径时，别把默认值弄丢了
直接 set_include_path('/my/libs') 会清空原有路径（包括当前工作目录 .），结果连 ./vendor/autoload.php 都找不到了。
必须保留原始路径并追加：
- ✅
set_include_path(get_include_path() . PATH_SEPARATOR . __DIR__ . '/includes'); - ✅ 然后才能放心写
include 'database.php';（前提是该文件真在/includes/下）
验证是否生效：
- 运行
var_dump(ini_get('include_path'));看输出是否含你新加的路径 - 用
var_dump(stream_resolve_include_path('database.php'));测试能否定位到文件，返回false就说明路径没配对
VS Code 报红但运行正常？那是 Intelephense 没同步路径
编辑器标红 include 'helper.php'，不代表 PHP 运行时报错——只是 Intelephense 静态分析时不知道你从哪开始执行，也不知道 __DIR__ 该算哪。
必须手动告诉它：
- 在
settings.json中配置："intelephense.environment.includePaths": ["${workspaceFolder}/app", "${workspaceFolder}/lib"] - 右键入口文件（如
public/index.php）→ Intelephense: Set as entry point - 重启 VS Code 窗口（仅重载不够）
注意：include_path 是运行时配置，Intelephense 完全不读它；你在 php.ini 里加的路径，必须单独填进插件配置里才管用。
最麻烦的其实是路径顺序和符号链接——一旦 include_path 里有两个同名文件，PHP 按从左到右加载，谁在前谁生效；而 realpath() 遇到软链会解析到底层真实路径，__DIR__ 却不会。这种差异在 Docker 或 NFS 挂载环境下特别容易暴露。
