如何在Composer中排除（exclude）特定文件以减小包体积？

composer.json 的 archive.exclude 是唯一官方支持的归档时排除文件的方式，仅影响 ZIP/TAR 打包，路径需以/开头并支持和*通配符，修改后须打新 tag 才生效。

composer.json 的 archive 配置能排除文件

Composer 本身不提供全局“exclude”命令，但打包发布时（如 composer archive 或 Packagist 自动抓取），会读取 composer.json 中的 archive 字段。这是唯一官方支持的、在生成 ZIP/TAR 包时剔除文件的方式。

它只影响归档行为，不影响本地 composer install 或依赖解析。

• archive 必须是对象，不能是布尔值或数组
• 只接受 exclude 键，值为字符串数组（支持 glob 模式）
• 路径匹配基于包根目录，不是绝对路径
• 不支持正则，仅支持 * 和 **（后者匹配多级目录）

{   "name": "myvendor/mylib",   "archive": {     "exclude": [       "/tests/",       "/docs/",       "/examples/",       "*.md",       ".gitignore",       "phpunit.xml"     ]   } }

别误用 autoload.exclude-from-classmap

这个配置常被当作“排除文件”的捷径，但它实际作用是：在生成 classmap 时跳过指定路径下的类文件，**不删除文件，也不影响包体积**。它只改变自动加载逻辑，对最终发布的 ZIP 包毫无影响。

• 适用于想保留测试类但不让它们进 classmap 的场景
• 路径需以 / 开头，表示相对于包根目录
• 若你目标是减小上传到 Packagist 的包大小，改这个没用

{   "autoload": {     "psr-4": { "MyVendor\MyLib\": "src/" },     "exclude-from-classmap": ["/tests/", "/benchmarks/"]   } }

Packagist 不执行 .gitattributes 或 .gitignore

很多人尝试用 .gitattributes 的 export-ignore 或 .gitignore 来控制 Composer 发布内容，但 Packagist **完全忽略这些文件**。它只认 composer.json 的 archive.exclude，以及你 Git tag 所指向的 commit 实际包含的文件。

• 如果你的 git archive 命令能排除某些文件，那只是本地行为，和 Composer 生态无关
• Packagist 下载的是 Git 仓库中该 tag 对应的完整树（tree），不会运行任何过滤脚本
• 真正有效的做法：确保你要排除的文件不在对应 tag 的 Git 提交里（比如用 git rm --cached + 提交），或者靠 archive.exclude

排除失败的常见原因和验证方式

最常踩的坑是路径写错或没触发归档流程。Packagist 只在你推送新 tag 后自动构建，不会重新打包已存在的版本。

• 修改 composer.json 后必须打**新 tag**（如从 v1.2.0 到 v1.2.1），旧版本不会更新
• 路径漏掉开头 /（如写 "tests/" 而非 "/tests/"）会导致匹配失败
• 用 composer archive mypkg.zip 本地测试时，确认 ZIP 解压后是否真不含那些文件
• Packagist 页面上点 “Download” 得到的 ZIP，才是最终生效的包，务必手动验证

真正起效的只有 archive.exclude + 新 tag。其他所有“排除”手段，要么无效，要么只作用于局部环节。