Composer如何在项目中禁用某些包的自动注册？（通过autoload exclude）

composer 中不存在 autoload.exclude 配置，真正可控制的排除机制仅有 exclude-from-classmap（仅限本项目 classmap）和 replace/provide 替代方案。

autoload.exclude 在 composer.json 中根本不存在

Composer 官方配置里没有 autoload.exclude 这个字段，所有试图在 autoload 下直接写 exclude 的做法都会被忽略，甚至可能触发警告或导致 autoloader 生成异常。

真正能“排除”某些包不被自动加载的机制，只存在于两个地方：包自身的 autoload 声明（你控制不了），以及你项目级的 autoload-dev 或 exclude-from-classmap 配置（你能控制）。

• 第三方包的 autoload 是它自己定义的，composer install 时会被合并进你的 vendor/autoload.php，你无法用配置“关掉”它
• 如果你只是不想让某个包的类被自动加载（比如它自带全局函数或触发副作用），唯一靠谱的做法是避免 require 它，或用 replace + provide 手段隔离
• exclude-from-classmap 是唯一接近“排除”的官方选项，但它只对 classmap 类型生效，且只能用于你自己的代码路径，不能指向 vendor/ 下的包

想阻止 vendor 包的类被自动加载？基本没得选

Composer 的 autoload 机制是“合并式”的：只要一个包在 vendor/composer/autoload_classmap.php 或其他 autoload 文件里注册了映射，它的类就可能被加载。你无法通过项目配置让 Composer “跳过”某个已安装包的 autoload 声明。

常见错误现象：Class 'SomeVendorBadClass' not found 看似是加载失败，实则是它被加载了但触发了致命错误（比如 PHP 版本不兼容、扩展缺失），而你以为是“没加载”——其实是加载后崩了。

• 不要尝试在 autoload 里加 "exclude": ["vendor/bad/package"] —— 这个字段压根不解析
• 不要改 vendor/composer/autoload_*.php 手动删映射 —— 下次 composer dump-autoload 或 update 就恢复
• 如果某包的 autoload 引入了你不想要的全局函数（如 function helper()），唯一安全方式是不装它，或用 replace 声明你已提供兼容实现

真正可用的替代方案：replace + provide + 自定义 autoloader

当你必须“禁用”某个包的自动加载行为（比如它和你的环境冲突），又不能卸载它（因为其他依赖需要），就得绕过 autoload 机制本身。

核心思路：告诉 Composer “这个包的功能我已经有替代实现”，让它跳过安装或加载其代码。

• 用 "replace" 声明你已提供某包的全部功能，Composer 就不会安装它（适用于完全替代场景）
• 用 "provide" 声明你提供了某虚拟包（如 "psr/log-implementation": "1.0"），满足依赖但不引入具体实现
• 手动 require 某些文件前，先用 spl_autoload_unregister() 卸载 Composer 的 autoloader，再按需加载 —— 仅限极少数集成场景，破坏性大
• 如果只是想屏蔽某个包的 classmap 映射，可把它移到 autoload-dev 下，并确保生产环境不运行 composer dump-autoload --dev

最容易被忽略的点：autoload 不等于 require

很多人以为“禁用 autoload”就能防止某包执行副作用，但其实很多包在 vendor/autoload.php 被引入时，就直接执行了顶层代码（如定义常量、调用 function_exists()、注册 shutdown 函数）。这类行为和 autoload 无关，而是由 Composer 的 files 加载机制触发的。

查证方法：看该包的 composer.json 里有没有 "autoload": { "files": [...] }；如果有，这些文件会在 vendor/autoload.php 中被 require_once，无法跳过。

• 这种 files 加载是硬编码进 vendor/composer/autoload_files.php 的，你改项目配置毫无影响
• 唯一办法是 fork 该包，删掉 autoload.files，然后用 repositories 指向你的版本
• 或者用 composer create-project 时不带该包，再手动 require 其他依赖，彻底绕开它

事情说清了就结束。