Composer装不上类库主因是autoload配置未生效，需检查PSR-4/classmap映射、执行dump-autoload刷新、确认files路径正确且不越界、区分require与require-dev加载范围。
composer require 装不上类库？先确认 autoload 配置是否生效
装了包却 class not found，大概率不是包没下全，而是 Composer 没把它的自动加载规则读进去。Composer 默认只认 vendor/autoload.php 这个入口，而且它只加载 composer.json 里声明过的 autoload 或 autoload-dev 规则——第三方包自己的 autoload 配置，是在它自己的 composer.json 里写的，require 时会被合并进主项目的 autoload map。
- 运行
composer require monolog/monolog后，检查vendor/composer/autoload_psr4.php是否新增了Monolog\的映射路径 - 如果手动改过根目录的
composer.json的autoload字段，记得执行composer dump-autoload刷新映射 - 某些老包（比如没维护的 GitHub repo）可能没写
autoload，只靠files加载单个文件，这种必须显式启用："autoload": { "files": ["src/helpers.php"] }，再dump-autoload
想直接加载一个外部 .php 文件？别用 require_once，走 composer files
临时加个工具函数文件、兼容旧逻辑、或者封装一个全局 helper，最稳的方式不是在代码里写 require_once '../lib/my_helper.php'，而是交给 Composer 管理——它会在每次 dump-autoload 时把这类文件塞进自动加载流程，且只加载一次，不重复 include。
- 在项目根目录
composer.json的autoload下加："files": ["lib/constants.php", "app/helpers.php"] - 路径是相对于
composer.json的，不能用../跳出项目根目录 - 修改后必须运行
composer dump-autoload，否则文件不会被加载 - 注意：这类文件会在所有请求中无条件加载，别塞大体积初始化逻辑或 DB 连接
PSR-4 和 classmap 混用时，为什么新类还是找不到？
当你既用了 psr-4 映射自己命名空间，又用 classmap 扫描某个目录，但新增的类仍报错，问题往往出在扫描时机和路径精度上。Composer 的 classmap 是静态生成的，不会监听文件变化。
-
classmap只在执行composer dump-autoload时扫描指定路径下的所有.php文件，生成类名 → 文件路径的硬映射 - 如果类文件放在
classmap声明路径之外（比如你写了"classmap": ["src/"]，但新类放在legacy/），它就永远进不了 autoload map - PSR-4 和 classmap 冲突时，PSR-4 优先级更高；但 classmap 里的类如果命名空间和 PSR-4 规则不匹配，也不会被 fallback 查找
- 调试建议：运行
composer dump-autoload -o --verbose，看输出里有没有扫描到你的新类文件
require-dev 的包在生产环境能用吗？
不能，除非你主动加载 vendor/autoload.php 时启用了 dev 模式，或者把 autoload-dev 合并进了主 autoload。默认情况下，require-dev 里的包只出现在 vendor/autoload_dev.php 中，且这个文件不被标准入口引用。
- 线上部署应使用
composer install --no-dev，此时autoload_dev.php根本不会生成 - 如果你在测试工具或命令行脚本里依赖
require-dev包，得确保运行环境加载的是完整 autoloader（比如在 CLI 脚本开头require 'vendor/autoload.php'，而不是自己手写 include） - 不要把
autoload-dev里定义的类名或文件路径，当成生产可用的契约——它们随时可能被删掉或重构
autoload 的本质是「告诉 PHP 在哪里找类」，不是「让 PHP 执行某段代码」。很多人卡在「文件明明存在，类就是不认」，其实只是 mapping 没刷、路径写错、或者压根没走 Composer 的加载链。最简单的验证方式：删掉 vendor/autoload.php，重新 composer install，再试——别跳过这一步。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
