Composer本身没有split命令，所谓“拆分”实为Git层面操作：必须用git filter-repo或git subtree导出子目录为独立仓库，并确保其composer.json含唯一name、主项目配置vcs repositories、子包打语义化标签，Composer才可加载。
Composer 本身没有 split 命令，所谓“拆分项目”不是 Composer 的职责，而是 Git 层面的事——你得先用 git filter-repo 或 git subtree 把代码从主仓库里物理导出成独立仓库，Composer 才有东西可装。
为什么 composer split 会报错或没反应
因为命令根本不存在。运行 composer split 会得到 Command "split" is not defined。Composer 是依赖加载器，不读目录结构、不改 Git 历史、不移动文件。它只认已发布的包（来自 Packagist、私有源或本地 path 仓库）。
-
composer require、composer update等所有命令都只操作composer.json和vendor/，不碰 Git - 想把
packages/http-client变成独立包？必须先在 Git 层完成导出，再确保新仓库有合法的composer.json - 误以为“加个 repositories 就能自动拆分”，结果是白忙活——repositories 只影响“怎么装”，不影响“怎么切”
该用 git filter-repo 还是 git subtree
优先选 git filter-repo，尤其当你要上线、做 CI、或需要干净历史时。它重写路径、保留作者和时间戳、不污染原仓库；git subtree 适合临时导出、不关心历史纯净度的场景。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
git filter-repo --subdirectory-filter packages/http-client --force：执行后当前目录只剩http-client内容，所有提交路径已重写为根目录，可直接推送到新远程 -
git subtree push --prefix=packages/http-client origin http-client：会在原仓库留下合并提交，且后续难以回滚 - 无论哪种，操作前必须
git clone --bare备份原仓库——git filter-repo会彻底重写历史，不可逆
拆完之后 Composer 怎么“认”这个新包
不是 Composer 主动“认”，是你得让它“找得到、解析得对、加载得进”。三个硬性条件缺一不可：
- 子包的
composer.json必须含全局唯一"name"字段，如"myorg/http-client"（不能是"http-client"或"./packages/http-client"） - 主项目若要试用，需在自己的
composer.json中repositories显式声明该包的 Git 地址：{"type": "vcs", "url": "https://github.com/myorg/http-client"} - 子包必须打带
v前缀的语义化标签（如v1.0.0），否则composer require myorg/http-client:^1.0会找不到版本
本地开发时如何避免反复 install 才能看到修改
别等发布再测。在主项目中用 path 类型仓库 + symlink，让 vendor/myorg/http-client 直接软链到本地 packages/http-client 目录。
- 主项目
composer.json中加：{"type": "path", "url": "packages/http-client", "options": {"symlink": true}} -
require写"myorg/http-client": "dev-main"（分支名要和子包实际一致） - Windows 用户注意：终端需以管理员身份运行，或已启用“开发者模式”，否则
mklink失败，Composer 会退化为 copy 模式 - 改完子包代码后，不用
dump-autoload，也不用update——只要软链建成功，立刻生效
最常被跳过的一步是验证软链接是否真实建立：进 vendor/myorg/http-client 看是不是个指向 ../packages/http-client 的符号链接，而不是一个普通目录。不是链接，就等于没配对。
