使用.gitattributes文件中的export-ignore指令可有效排除Composer包发布时的无关文件，如测试、示例等目录，确保dist包简洁；也可在composer.json中配置archive.exclude实现类似效果，但优先级低于.gitattributes；若需项目安装时精简依赖，应联系维护者优化或寻找轻量替代方案。
Composer 本身在安装和更新依赖时，主要处理的是 vendor 目录下的包文件，它不会自动把你的项目源码打包发布。但如果你是创建一个 Composer 包（比如类库），并希望在分发时排除某些文件或目录（如测试文件、文档、示例代码等），可以通过配置 composer.json 中的 archive 配置或使用 .gitattributes 文件来实现。
1. 使用 .gitattributes 排除文件（推荐用于 Git 仓库）
如果你的包托管在 Git 上，并通过 Composer 的 dist 方式分发（即打 tag 后发布的压缩包），Composer 会基于 Git 的归档机制生成压缩包。这时可以使用 .gitattributes 文件来指定哪些文件在打包时被排除。
在项目根目录创建或编辑 .gitattributes 文件：
/tests export-ignore/examples export-ignore
/.gitattributes export-ignore
/README.md export-ignore
上面的配置表示：在执行 git archive（也就是 Composer 下载 dist 包时）会忽略这些文件或目录。
2. 在 composer.json 中定义 archive 配置
你也可以在 composer.json 中明确指定哪些文件包含或排除在归档包之外（适用于更精细控制）：
{ "name": "your-vendor/your-package", "archive": { "exclude": [ "/tests/", "/examples/", "/*.md", "/config-dev.php", "/var/" ] } }注意：该功能需要确保你使用的打包工具支持此配置（如 composer archive 命令或 CI 构建流程中正确处理）。不是所有环境都默认启用此行为，尤其是当包从 Git 自动构建时，仍以 .gitattributes 为准。
3. 不想让某些文件进入 vendor（项目依赖中）
如果你是项目开发者，只是不想某些依赖中的文件被加载或影响项目，Composer 本身不提供“安装依赖时排除其子文件”的功能。但你可以：
- 联系包维护者优化其
.gitattributes - 使用脚本在
post-autoload-dump或post-install-cmd中手动删除不需要的文件（不推荐，破坏完整性） - 考虑是否真的需要该依赖，或寻找更轻量替代方案
基本上就这些方法。最常用且可靠的是 .gitattributes + export-ignore，适合大多数开源 PHP 包的发布场景。只要打好标签，Composer 自动获取的 dist 包就会干净。
