include-path 在 Composer 中无效，因它不是 composer.json 支持的配置项；Composer 自动加载不依赖 PHP 的 include_path，仅 classmap 或 files 可兼容传统 require 写法。

include-path 在 Composer 中没有特殊配置能力——它不是 Composer 的配置项，也不被 composer.json 支持。试图在 autoload 或 config 段里写 "include-path" 字段，Composer 会完全忽略，不会报错，也不会生效。

为什么 include-path 配置无效

PHP 自身的 include_path ini 设置（如通过 set_include_path() 或 php.ini）与 Composer 的自动加载机制是两套独立系统：

• Composer 的 autoload.php 不读取、不依赖、也不修改 PHP 的 include_path
• 即使你用 set_include_path(__DIR__ . '/lib')，require 'SomeClass.php' 仍需手动写路径，无法触发命名空间自动加载
• include_path 只影响 require/include 的相对路径查找，对 new AppService() 这类基于命名空间的调用毫无作用

想兼容传统 include_path 项目的正确做法

老项目如果大量使用 require 'utils/Helper.php' 这类写法，又不想重构成 PSR-4，有且仅有两个可行路径：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 把所有被 include 的目录统一移到一个位置（如 src/legacy），然后用 "classmap": ["src/legacy"] 让 Composer 扫描并注册类名映射
• 若文件里只有函数/常量（无 class/interface），改用 "files": ["src/legacy/helpers.php"]，确保每次加载 autoload.php 时都执行一次
• 绝对不要在 composer.json 里加 include-path 字段——它不存在于 Composer Schema 中，JSON 校验都通不过

vendor/autoload.php 加载后还能用 include_path 吗

可以，但必须手动控制，且顺序关键：

• 先 require_once 'vendor/autoload.php'，再 set_include_path(...)，否则旧代码里的 require 'Config.php' 仍会失败
• 若旧代码中混用 require 和 new，优先确保类能被 Composer 加载（用 classmap 或 psr-4），再让 include_path 处理纯脚本
• Windows 下注意路径分隔符：用 DIRECTORY_SEPARATOR 拼接，别硬写 / 或 \

真正需要的从来不是 include-path 配置，而是明确告诉 Composer “这些文件归谁管”。一旦走错方向去折腾 ini 设置或自定义字段，问题只会从类找不到，变成 autoload 乱序、缓存残留、CI 构建失败——这些比路径写错更难排查。