Composer status命令用于检查本地依赖包是否被修改，帮助开发者发现vendor目录中的代码变更，避免因未记录的修改导致环境不一致问题。运行composer status可列出所有被修改（M）、新增（A）或删除（D）的依赖包，便于确认变更来源并采取恢复或提交措施。若需检查特定包状态，可用composer show -i package-name查看其是否处于modified状态。为防止意外修改，建议通过fork仓库并提PR的方式贡献代码，或使用composer-patches插件管理本地补丁。该插件可在composer install/update时自动应用patch文件，确保修改持久化。若composer status无输出，可能是git未追踪vendor目录或.gitignore忽略了该目录，需调整配置。此外，也可用git diff vendor/package-name手动检查变更。但需注意，composer status仅检测文件内容变化，无法识别权限或元数据变更，且依赖本地文件系统，共享目录中可能失效。在CI/CD中可集成composer status，通过非零退出码中断构建，防止带修改的依赖进入生产环境。
Composer status 命令主要用于检查本地安装的依赖包是否有代码变更，这对于追踪项目依赖的修改非常有用。它能快速告诉你，你本地的 vendor 目录下的代码是否与原始版本存在差异，帮助你排查潜在的问题或确认修改是否符合预期。
检查本地依赖包代码变更的几种方式：
为什么需要检查依赖包变更？
很多时候，我们会在本地调试或修复第三方库的bug，直接修改了 vendor 目录下的代码。但这种修改如果没有被记录和同步，可能会导致项目在其他环境出现问题。
composer status
就是为了解决这个问题，它能让你清楚地知道哪些依赖包被修改过，方便你将修改提交到上游仓库或进行其他处理。
Composer status 的使用方法
最简单的用法就是在项目根目录下运行
composer status
。
composer status
如果你的 vendor 目录不在项目根目录下，可以使用
--working-dir
参数指定目录。
composer status --working-dir=/path/to/vendor
如何处理 Composer status 的输出结果？
composer status
会列出所有被修改过的依赖包。对于每个被修改的包，它会显示一个状态信息，例如 “M” 表示被修改，”A” 表示新增，”D” 表示删除。你可以根据这些信息来判断修改的类型和范围。
如果你确定这些修改是临时的，或者你已经将修改提交到上游仓库，你可以使用
composer install
或
composer update
来恢复到原始版本。
检查特定依赖包的状态
如果你只想检查某个特定依赖包的状态，可以使用
composer show -i <package-name>
命令。虽然它不是专门用来检查代码变更的，但它可以告诉你这个包是否是 “modified” 状态。
composer show -i vendor/package-name
如何避免 vendor 目录被意外修改？
最好的方法是不要直接修改 vendor 目录下的代码。如果需要修改，应该 fork 对应的仓库，修改后提交 pull request。或者，你可以使用 composer 的 patch 功能，将你的修改应用到 vendor 目录下的代码。
使用 composer-patches 管理本地修改
composer-patches
是一个非常有用的 composer 插件，可以让你方便地管理本地的修改。你可以将你的修改保存为 patch 文件，然后通过 composer 安装 patch。这样，即使你更新了依赖包，你的修改也会被自动应用。
首先，安装
composer-patches
插件：
composer require cweagans/composer-patches
然后，创建一个 patch 文件，例如
patches/vendor-package.patch
。
在你的
composer.json
文件中添加以下配置：
"extra": { "patches": { "vendor/package-name": { "My patch description": "patches/vendor-package.patch" } } }
每次执行
composer install
或
composer update
时，composer 都会自动应用这些 patch。
为什么我的 Composer status 没有显示任何变更？
这可能是因为你的 git 没有追踪 vendor 目录下的文件。你可以尝试在项目根目录下运行
git add vendor
，然后再次运行
composer status
。
另外，确保你的
.gitignore
文件没有忽略 vendor 目录。
除了 Composer status，还有哪些方法可以检查代码变更？
你可以使用
git diff
命令来检查 vendor 目录下的代码变更。
git diff vendor/package-name
这个命令会显示 vendor 目录下指定包的所有修改。
Composer status 命令的局限性
composer status
只能检查本地文件系统的变更。如果你的 vendor 目录是挂载的共享目录，或者使用了其他文件系统，
composer status
可能无法正确检测到变更。
此外，
composer status
只能检测到文件内容的变更，无法检测到文件权限或元数据的变更。
如何在 CI/CD 流程中使用 Composer status？
你可以在 CI/CD 流程中使用
composer status
来检查是否有意外的依赖包修改。如果
composer status
返回任何非零的退出码，就表示有依赖包被修改，可以中断构建流程，防止潜在的问题被发布到生产环境。
例如，在 Jenkins 中，你可以添加一个 shell 脚本步骤：
composer status if [ $? -ne 0 ]; then echo "Error: Vendor directory has been modified." exit 1 fi
composer js git json jenkins 为什么 composer json git jenkins bug