答案:vendor目录不应提交以避免仓库膨胀、更新困难、合并冲突和冗余存储;只需提交composer.json和composer.lock文件,通过composer install还原依赖。例外情况包括无法联网部署或需独立分发时可提交vendor,但应权衡维护成本。常规做法是在.gitignore中忽略/vendor并保留.gitkeep以维持目录结构,这是PHP社区保持仓库轻量的通用实践。

Composer 的 vendor 目录通常不需要提交到 Git。
为什么 vendor 目录不应提交到版本控制?
PHP 项目使用 Composer 管理依赖,所有第三方库都安装在 vendor 目录中。这个目录的内容是由 composer.json 和 composer.lock 文件决定的。开发者只需提交这两个文件,其他人就可以通过composer install 命令还原相同的依赖环境。
提交 vendor 目录会带来以下问题:
- 仓库体积膨胀:vendor 包含大量第三方代码,会使 Git 仓库变得非常庞大。
- 更新困难:每次更新依赖都要提交大量文件变更,难以审查实际改动。
- 容易冲突:多人协作时,vendor 文件容易产生合并冲突。
- 冗余存储:每个分支都保存一份依赖,浪费空间和带宽。
应该提交哪些 Composer 相关文件?
为了确保团队和生产环境的一致性,建议提交以下文件:- composer.json:定义项目依赖。
- composer.lock:锁定依赖的具体版本,保证所有人安装一致。
composer install 就能重建 vendor 目录。
例外情况:何时可以提交 vendor?
极少数场景下可考虑提交 vendor,例如:- 项目部署环境无法联网,不能执行
composer install。 - 作为独立分发包,需要开箱即用(如开源工具、PHAR 构建前的快照)。
如何忽略 vendor 目录?
在项目根目录的 .gitignore 文件中添加:/vendor !/.gitkeep如果想保留 vendor 目录结构但不提交内容,可在
vendor/ 中添加空的 .gitkeep 文件并取消忽略。
基本上就这些。坚持不提交 vendor 是 PHP 社区的通用实践,配合 composer.lock 使用,既能保证一致性,又保持仓库轻量。










