Composer 是 PHP 依赖管理工具，不构建微服务；正确做法是各服务独立仓库、独立 composer.json 和 vendor，共享逻辑抽为私有包并规范 autoload 与版本约束。
Composer 不搭建微服务，也不“中文搭建”——它只是 PHP 的依赖管理工具，语言无关，不存在“中文版 Composer”。所谓“用 Composer 搭建微服务”，本质是**用 Composer 管好每个服务内部的依赖边界**，防止跨服务耦合。真正决定是否是微服务的，是目录隔离、通信方式（HTTP/消息队列）、部署粒度和团队协作约定。
每个微服务必须有独立 composer.json 和 vendor
把所有服务塞进一个仓库、共用一个根级 composer.json，等于自废解耦能力：
-
composer install会把用户、订单、支付等所有服务的包全装进同一个vendor/，运行时类加载冲突、Class not found错误难定位 -
autoload映射若跨服务写成"Order\": "../order-service/src/"，上线后路径失效，且违反服务自治原则 - CI/CD 构建镜像时无法只打包当前服务代码 + 其
vendor/，体积膨胀、启动变慢、安全风险上升
正确做法：每个服务开独立 Git 仓库，如 user-service/、order-service/，各自维护自己的 composer.json。
共享逻辑必须抽成私有 Composer 包，不能 require 其他服务目录
多个服务都用同一套 ID 生成器、DTO 或异常基类？别这么干：
-
composer require ../order-service/src或硬拷文件 → 部署耦合写死，一改全崩，版本无法控制 -
"repositories": [{"type": "path", "url": "../shared-dto"}]仅限本地开发联调，上线前必须切回 VCS 源 - 私有包的
composer.json中autoload必须写对："psr-4": {"Domain\": "src/"}，路径写"src/"，不是"./src/"或"src"（少斜杠会失效） - 各服务中声明依赖时，必须带明确版本或分支：
composer require example/domain-models:^2.1或dev-main，否则 Composer 找不到包
认证走 auth.json，内容为 {"http-basic": {"gitlab.example.com": {"username": "token", "password": "PAT_abc123"}}}，不用 SSH URL —— CI 环境通常没配密钥。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
CI/CD 中只跑 composer install，禁用 composer update
composer update 是开发阶段的手动行为，上线和流水线里执行等于埋雷：
- 它忽略
composer.lock，按composer.json重算依赖树，可能让 A 服务锁在shared-utils v2.1，B 服务却升到v3.0 - 接口签名变了、字段丢了、没报错，数据就静默丢失——这类问题线上极难复现
- CI 步骤必须是：
cd user-service && composer install --no-dev --optimize-autoloader - 生产镜像中只
COPY当前服务目录 +vendor/，不包含其他服务任何文件
提交 composer.lock 到 Git 是强制要求，否则环境一致性无法保障。
autoload 写错，错误只在运行时报，且不提示来源
共享包的类找不到，90% 是 autoload 配置问题，但 composer install 不报错，只有请求进来才炸：
- 共享包自己的
composer.json里，必须用"autoload"（不是"autoload-dev"）声明映射 - 命名空间末尾反斜杠要双写为
\，否则 JSON 解析失败，Composer 直接跳过该段 - PSR-4 路径必须相对于包根目录，
"src/"不能写成"./src/"；若包结构是src/ValueObject/Email.php，命名空间就得是Domain\ValueObject\ - 改了共享包的类结构后，调用方服务需执行
composer dump-autoload更新自动加载映射，否则仍用旧缓存
最易被忽略的一点：不同服务可以使用不同 PHP 版本或扩展（比如有的需 ext-amqp），只要各自 composer.json 声明清楚，Composer 就不会干涉——它只管“装对包”，不管“跑得通不通”。架构层面的容错、发现、熔断，得靠 Consul、API 网关或 Swoole 补足。
