vendor 目录需加入 .gitignore，因其内容由 Composer 自动管理，提交会导致仓库膨胀、协作冲突；通过 composer.json 和 composer.lock 可确保环境一致，标准流程下只需安装依赖，无需提交 vendor，属 PHP 社区最佳实践。

Composer 的 vendor 目录需要加入 .gitignore，是因为这个目录中的内容是通过 composer install 或 composer update 自动下载和管理的第三方依赖包，不需要手动维护或提交到版本控制系统中。

避免重复提交依赖代码

vendor 目录里存放的是项目所依赖的外部库（如框架、工具类等），这些库本身都有自己的版本控制和发布流程。如果把这些文件提交到你的项目仓库，会导致：

• 仓库体积迅速膨胀
• 每次更新依赖都会产生大量无关代码变更
• 多人协作时容易出现冲突且难以解决

确保环境一致性

只要项目根目录有 composer.json 和 composer.lock，任何人在执行 composer install 后都能得到完全一致的依赖版本。

composer.lock 记录了确切的版本号和哈希值，保证团队成员和生产环境安装的是相同的依赖组合。

标准协作流程更清晰

开发者只需关注自己写的代码和依赖声明，而不是依赖的具体实现。部署时通过自动安装依赖即可：

• 克隆项目后运行 composer install
• CI/CD 流程中自动安装指定版本的依赖
• 无需担心 vendor 中某个文件被意外修改导致不一致

例外情况说明

某些特殊场景下（如构建独立可分发的应用、嵌入特定修改过的包），可能需要提交部分 vendor 文件，但这是少数情况，通常意味着架构需要重新评估。

基本上就这些 —— 不把 vendor 提交到 Git，是 PHP 社区广泛遵循的最佳实践，简化协作、提升效率、减少错误。.