Composer利用Git Subtree在不破坏主库依赖下同步共享组件-composer-PHP中文网

git subtree子项目必须在自身目录执行composer install并配置vendor-dir、--no-autoloader、--no-scripts，显式声明独立psr-4命名空间，且子项目.gitignore需强制提交以隔离vendor。

composer利用git subtree在不破坏主库依赖下同步共享组件

Git subtree 项目里直接 composer install 会把依赖装进主项目的 vendor/，导致类加载冲突、CI 构建失败、dump-autoload 扫描错乱——这不是 bug，是 Composer 本身没“作用域”概念，它只认当前目录或向上最近的 composer.json。

子项目执行 `composer install` 必须加 `--no-autoloader --no-scripts`

不加这两个参数，Composer 会尝试注册 autoload、执行 post-install-cmd 等钩子，而这些动作默认基于主项目上下文运行，极易触发主项目 autoload.php 的重写或脚本误执行。

必须在子项目目录（即 subtree 目录）下执行，不是主项目根目录
--no-autoloader 阻止生成 vendor/autoload.php，避免覆盖主项目自动加载逻辑
--no-scripts 跳过所有 scripts 段定义的命令，防止子项目脚本污染主项目构建流程
后续需手动运行 composer dump-autoload --working-dir=lib/my-subtree 单独生成子项目 autoload

`vendor-dir` 必须显式配置为子项目专属路径

默认情况下，Composer 总把包装进离当前目录最近的 composer.json 所在位置的 vendor/。子项目若不干预，就会和主项目共用一个 vendor/ 目录，命名空间映射互相覆盖。

github项目持续追踪

GitHub 项目更新追踪工具 - 自动检查多个 GitHub 项目的 Releases 和 CHANGELOG，生成更新摘要与影响分析报告。支持自动化定时任务。如何使用最简单的方式：直接用自然语言告诉我你可以说我会做「检查 GitHub 更新」检查最新版本「添加 vscode」追踪新项目「停止追踪 xxx」移除项目「暂停更新检查」暂停自动化「给我看 openclaw 报告」展示报告触发词：「追踪项目更新」「检查 GitHub 更新」「项目更新报告」「设置更新提醒」

下载

在子项目自己的 composer.json 的 config 段写："vendor-dir": "lib/my-subtree/vendor"
路径必须唯一且不与主项目重叠，比如不能用 vendor 或 ../vendor
该配置仅对子项目生效；主项目 composer.json 不需要、也不应该声明此字段
确认路径可写，尤其 CI 环境中要提前 mkdir -p lib/my-subtree/vendor

子项目 `autoload` 必须用 `psr-4` 显式声明，且绝不重叠主项目命名空间

如果子项目 autoload 写成 "App": "src/" 这种宽泛映射，或和主项目用了相同前缀（如都用 App\），composer dump-autoload 时会把两类类混在一起扫描，运行时报 Class not found 或加载了错误版本。

子项目 composer.json 中只声明自身命名空间，例如："MySubtree\": "src/"
主项目 autoload 和 autoload-dev 里，绝对不能包含子项目源码路径（如 "src/subtree/"）
不要依赖 Composer 自动发现；禁用 "autoload": {"psr-4": {}} 空配置，否则可能触发意外扫描
验证方式：composer dump-autoload -d lib/my-subtree && grep MySubtree vendor/composer/autoload_psr4.php