vendor/autoload.php 是 composer 自动生成的只读文件，不应手动修改或纳入版本控制；自定义加载逻辑须通过 composer.json 的 autoload 字段配置，并运行 composer dump-autoload 生效。
composer install/update 时 autoload.php 被重写怎么办
根本原因不是 Composer 故意“覆盖”，而是它每次执行 composer install 或 composer update 都会重新生成 vendor/autoload.php —— 这个文件是自动生成的入口，**你不该手动改它，也不该把它纳入版本控制或依赖它做自定义加载逻辑**。
常见错误现象：vendor/autoload.php 里被你加了 require_once 'my-custom-loader.php'，结果下次 composer update 就没了；或者 CI 环境里因权限问题报 failed to open stream: Permission denied，其实是误触了生成逻辑。
- 所有自定义自动加载逻辑必须通过
composer.json的autoload字段声明，而不是动vendor/autoload.php -
vendor/autoload.php是只读产物，应被 git 忽略（确保.gitignore里有/vendor/） - 若项目需要在 Composer 加载后追加逻辑（比如全局函数注册、调试钩子），应放在项目自己的入口文件（如
index.php或public/index.php）中，在require vendor/autoload.php之后执行
如何把私有类库和 Composer 自动加载合并起来
典型场景：你有一套内部工具类放在 lib/Utils，不想发布到 Packagist，但又希望它们像 Composer 包一样被自动加载。这时候不能靠改 autoload.php，而要靠 composer.json 的 autoload 配置。
关键点在于：Composer 支持多种自动加载方式，但只有声明在 composer.json 中的才会被写入最终的 autoload.php。
立即学习“PHP免费学习笔记（深入）”；
- 用
"psr-4"最稳妥："autoload": { "psr-4": { "MyCompany\": "lib/" } }然后运行composer dump-autoload，Composer 就会把lib/Utils/Helper.php映射为MyCompanyUtilsHelper - 如果类没命名空间（老代码），用
"files"数组直接加载 PHP 文件："autoload": { "files": ["lib/functions.php", "lib/constants.php"] }这些文件会在每次require vendor/autoload.php时无条件执行 - 注意：修改
composer.json后必须运行composer dump-autoload（开发时）或等install/update触发重建，否则不会生效
多个项目共享同一份 autoload 配置？别这么干
有人想让 A 项目和 B 项目共用一个 vendor/autoload.php，甚至用符号链接指向同一份，这是高危操作。
原因很实在：Composer 的 autoloader 是按当前 composer.json 和 vendor/composer/autoload_*.php 生成的，路径、命名空间、类映射都绑定在当前项目根目录下。跨项目复用会导致：
- 类找不到（
Class not found），因为 PSR-4 映射路径是相对当前项目根的 - 同名包版本冲突（比如 A 用
monolog/monolog ^2.0，B 用^3.0），vendor/autoload.php只能反映其中一个项目的依赖图 -
composer dump-autoload -o生成的优化文件（autoload_classmap.php）包含绝对路径，换环境就失效
正确做法是：每个项目维护独立的 composer.json 和 vendor/，通过私有 Packagist（如 Satis 或 Private Packagist）或 Git 仓库 + "repositories" 引入内部包，而不是共享 autoloader 文件。
dump-autoload 的 -o 和 --classmap-authoritative 有什么区别
这两个参数都会影响 vendor/autoload.php 的行为，但作用层次不同，容易混淆。
-
composer dump-autoload -o：生成类映射表（vendor/composer/autoload_classmap.php），跳过 PSR-4/PSR-0 的文件系统扫描，提升加载速度。但仍是“fallback”模式——如果类不在映射表里，Composer 还会尝试按规则找文件 -
composer dump-autoload --classmap-authoritative：告诉 autoloader “映射表就是全部”，不再 fallback 到文件系统扫描。这意味着：没进 classmap 的类一定加载失败，哪怕它物理存在且符合 PSR-4 规则 - 两者可同时用：
composer dump-autoload -o --classmap-authoritative，适合部署环境，但开发时慎用——新增类后必须重新dump-autoload，否则会静默失败 - 如果你用了
"files"类型加载，它们不受--classmap-authoritative影响，始终会被包含
真正容易被忽略的是：--classmap-authoritative 不会自动帮你把所有类扫进 classmap，它只是“信不信这张表”的开关。扫表动作仍由 -o 或 --optimize 触发，而且只扫 "autoload" 声明的路径，不扫 vendor/ 外的随意目录。
