Composer如何排除特定的文件或目录

使用.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 文件：

上面的配置表示：在执行 git archive（也就是 Composer 下载 dist 包时）会忽略这些文件或目录。

2. 在 composer.json 中定义 archive 配置

你也可以在 composer.json 中明确指定哪些文件包含或排除在归档包之外（适用于更精细控制）：

标签： php js git json composer 工具