Composer如何给开源项目贡献代码_Composer给开源项目贡献代码要点-composer-PHP中文网

直接 fork 后 composer install 报错是因为 composer 默认从 packagist 拉正式版，不识别本地修改；需配置 path 类型仓库、用 "*" 版本、执行 composer update 而非 install，并确保提交 composer.json、composer.lock 和 autoload-dev 更新。

composer如何给开源项目贡献代码_composer给开源项目贡献代码要点

直接 fork 项目后用 `composer install` 报错？先确认是否用了 `path` 仓库类型

本地开发贡献时，很多人 clone 了 fork 后的仓库、改完代码就跑 composer install，结果发现依赖没拉你本地的修改，甚至报 Package not found。根本原因：Composer 默认从 Packagist 拉正式版，不认你本地目录。

解决方式是配置 path 类型仓库，让 Composer 明确知道“这个包就在我电脑上”：

{
    "repositories": [
        {
            "type": "path",
            "url": "../my-forked-package"
        }
    ],
    "require": {
        "vendor/package-name": "*"
    }
}

注意三点：

url 必须是相对路径（从当前 composer.json 所在目录算起），不能是绝对路径或 file://
require 中的版本号写 "*" 或 "dev-main"，不能写 "1.2.3" —— 否则 Composer 仍会优先匹配 Packagist 上的稳定版
执行 composer update vendor/package-name 而非 install，否则缓存可能跳过仓库重解析

`composer require --dev` 加的包为什么 PR 后 CI 不通过？

你在本地加了 phpunit/phpunit 做测试，用 composer require --dev phpunit/phpunit，CI 却报 Class 'PHPUnit\Framework\TestCase' not found。问题不在命令本身，而在提交时漏掉了关键文件。

必须确保以下两项都进了 Git：

composer.json 中新增的 require-dev 条目
composer.lock 文件 —— 尤其当项目启用了 composer install --no-dev 的 CI 流程时，CI 会严格按 lock 文件还原，没提交 lock 就等于没加依赖

顺带提醒：composer.json 里的 autoload-dev 如果新增了测试类路径，也要同步提交，否则自动加载器找不到你的 tests/ 下的类。

提交前运行 `composer validate` 和 `composer normalize` 是不是多此一举？

不是。很多开源项目 CI 会卡在 composer validate 这一步，报 license field is missing 或 description is missing。这些字段虽不影响本地运行，但 Packagist 强制要求，PR 无法合并。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

composer validate 会检查基础合规性；composer normalize 则统一格式（比如把 psr-4 的缩进、逗号位置标准化），避免因空格/换行被维护者手动 reject。

建议在 pre-commit 钩子里加上：

composer validate --no-check-all --strict && composer normalize --dry-run

如果失败，就别提交 —— 大部分维护者不会帮你修 JSON 格式。

为什么改完代码跑了 `composer dump-autoload`，测试还是用旧逻辑？

你改了 src/ 下的类，执行 composer dump-autoload，但 phpunit 运行时仍加载旧版本。常见原因是：

项目用了 classmap autoload 方式，而你新增的类没在 composer.json 的 autoload.classmap 里声明 —— dump-autoload 不会自动扫描，得手动加路径或改用 psr-4
你改的是被其他包依赖的类，但那个包本身没更新 composer.lock，导致它还在用旧版本的缓存 autoloader
CLI 环境和 Web 环境用了不同 vendor 目录（比如 Docker 容器内外），dump-autoload 只作用于当前 vendor

最稳的排查方式：删掉 vendor/autoload.php，再跑一次 composer install，强制重建全部映射。

真正容易被忽略的是：有些项目把 autoload 配置放在 composer.json 的根级别，有些却藏在 extra 或插件配置里 —— 改代码前先看全文件，别只盯 src/ 目录。