执行 composer require vendor/package:dev-main 会修改 composer.json 的 require 字段和 composer.lock 文件，前者写入版本约束，后者记录实际 commit hash 和源地址，不修改 require-dev（除非加 --dev 参数）。

composer require dev-分支名会改哪些文件？

执行 composer require vendor/package:dev-main 会同时修改两个文件：composer.json 的 require 字段（写入 "vendor/package": "dev-main"），以及 composer.lock（记录实际拉取的 commit hash 和源地址）。它不会碰 require-dev，除非你加了 --dev 参数。

为什么写了 dev-main 却没拉到最新提交？

常见原因有三个：

• composer.lock 里已锁死旧 commit，而你只运行了 composer install——它完全无视 composer.json 里的 dev-main，只照 lock 文件还原
• 远程分支名拼错，比如写了 dev-master 但仓库实际是 main；Composer 不报错，悄悄回退到最近 tag（如 v2.3.0）
• 没配 "minimum-stability": "dev" 或没在包版本后加 @dev，导致 Composer 拒绝解析 dev- 前缀

怎么验证真的用了目标分支？

别信 composer show vendor/package 输出的 versions : dev-main，它只是别名。进 vendor/vendor/package/ 目录后执行：

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• git rev-parse --abbrev-ref HEAD —— 看输出是不是 main
• git log -1 --oneline —— 比对 commit hash 是否和 GitHub/GitLab 上该分支最新提交一致

本地开发时想实时同步代码，怎么避免反复 composer update？

用 path 类型仓库 + symlink 选项：

• 在项目 composer.json 的 repositories 里加一条：{"type": "path", "url": "../my-local-package", "options": {"symlink": true}}
• 本地包的 composer.json 中 name 必须匹配（如 "acme/utils"），且不能以 ./ 开头
• 运行 composer require acme/utils:dev-main，此时 vendor/acme/utils 是个符号链接，改本地源码立刻生效

注意：不启用 symlink 时，默认行为是拷贝，改了本地代码必须手动 composer update acme/utils 才能同步。