结论：抽离公共代码为独立 Composer 包，本质是初始化标准 PHP 项目并正确配置 autoload（如 PSR-4）、目录结构与命名空间匹配、打 v 前缀语义化标签；本地开发用 path 仓库类型实现热更新；发布需提交 Packagist 或配置私有仓库；多项目共用须严格遵循 SemVer 并锁定 patch 版本。
怎么把公共代码抽成独立 Composer 包
直接结论：不是“打包”，而是“初始化一个带 composer.json 的标准 PHP 项目”，再把它当成普通包发布到 Packagist 或私有仓库。关键不在“怎么打包”，而在“怎么让它被其他项目 require 时能自动加载类”。
实操上，你不需要写任何特殊构建脚本，只要保证三件事：目录结构合理、autoload 配置正确、版本打标签。常见错误是直接把旧项目里的 src/ 文件夹拖出来就扔进新仓库，结果 composer install 后类根本找不到——因为没配自动加载。
- 用
composer init初始化新仓库，填好name（格式必须是vendor/name，比如myorg/utils），别跳过 -
autoload推荐用"psr-4"，映射到src/目录：{"autoload": {"psr-4": {"MyOrg\Utils\": "src/"}}} - 类文件路径必须匹配命名空间，比如
src/Helper.php里得写namespace MyOrgUtils; - 别忘了
git tag v1.0.0，Composer 默认只认带v前缀的语义化标签
本地开发时怎么边改边测试，不用反复 composer update
核心问题：改了包代码，主项目里看不到更新。这不是缓存问题，是 Composer 默认把包复制进 vendor/，改源码根本没用。
解决办法是用 path 仓库类型，让 Composer 直接软链接到你的本地包目录。这样改一行，主项目立刻生效，连 dump-autoload 都不用跑。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在主项目的
composer.json里加repositories段：{"repositories": [{"type": "path", "url": "../my-utils"}]} -
url是相对于主项目composer.json的路径，必须真实存在且含composer.json - 然后
composer require myorg/utils:dev-main（分支名要对），不是^1.0 - 注意：这种模式下
composer update会忽略远程更新，只读本地；上线前务必切回正式版本
composer install 报错 “could not find package xxx”
典型现象：明明包已推到 GitHub，也打了 tag，但 composer require vendor/name 就报找不到。大概率卡在三个地方。
- Packagist 没手动 submit：GitHub 仓库不会自动同步到 Packagist，得去 packagist.org 提交一次
vendor/name - 私有包没配仓库：如果走公司私有 GitLab 或 Satis，主项目
composer.json必须显式声明repositories，且type设为vcs或composer - 名字拼错或大小写敏感：Composer 包名全小写，
MyOrg/Utils和myorg/utils是两个包；GitHub 仓库名也必须完全一致 - Tag 名不合法：
v1.0可以，1.0.0不行（缺v）；dev-master分支存在但没设minimum-stability也会失败
多项目共用时，怎么避免 A 项目升级破坏 B 项目的兼容性
本质是语义化版本（SemVer）没被真正执行。很多团队打 v2.0.0 只是因为“改得比较多”，其实只是加了个方法——这不该破兼容。
关键动作不是技术配置，而是发布前的检查习惯：
- 每次发版前用
phpstan或psalm扫描src/，确认没删/改 public 方法签名 - 在包里写最小单元测试，覆盖所有公开接口；CI 里跑
composer test再合并 - 主项目不要写
"myorg/utils": "^1.0"这种宽泛约束，生产环境锁定具体 patch 版本，比如"1.2.3" - 如果真要破兼容，必须升主版本号（
v2.0.0），并确保旧项目还能通过"^1.0"安装到最新 v1.x
最常被忽略的一点：包的 composer.json 里 require 的 PHP 版本、扩展，会透传给主项目。比如包写了 "ext-gmp": "*"，但某个老项目没装 gmp 扩展，composer install 就直接失败——这个依赖链很容易漏审。
