模块化开发的核心是拆分职责，不是拆目录；真正有效的模块化是能独立测试、独立版本、独立复用的最小逻辑单元，需通过接口协作、显式依赖声明、严格命名空间映射与path仓库联调保障可维护性。
模块化开发的核心是拆分职责，不是拆目录
模块化不是把代码按功能塞进不同子目录就完事。真正有效的模块化，是你能独立测试、独立版本、独立被其他项目复用的最小逻辑单元。比如一个「异常处理增强包」，ExceptionHelper 类负责格式化，ExceptionReporter 负责上报，ExceptionHandlerMiddleware 负责 Laravel 中间件集成——它们共用同一命名空间，但各自承担明确边界，且不互相强依赖。
常见错误是把所有类堆在 src/ 下，靠注释或文档“约定”模块边界。结果一改就破，一测就漏。正确做法是：每个模块对应一个可单独实例化的类或接口，通过构造注入协作，而非直接 new 或静态调用。
- 避免在
src/下写全局函数或未封装的工具方法，它们会破坏可测试性 - 模块间通信尽量通过接口（如
Reportable），而非具体类名 - 如果某个模块需要配置，不要硬编码在构造函数里，提供
withConfig()链式方法或工厂类
PSR-4 命名空间映射必须与模块结构严格对齐
Composer 的自动加载机制只认路径和命名空间的映射关系，不认你心里想的“模块”。比如你定义了 "MyPackage\Logger\": "src/Logger/"，那 MyPackageLoggerFileHandler 就必须落在 src/Logger/FileHandler.php；若你把它放在 src/Handlers/FileHandler.php，Composer 就找不到，报错 Class "MyPackageLoggerFileHandler" not found。
容易踩的坑：
- 命名空间用了下划线（如
MyPackage_Logger）——PSR-4 不支持，必须用反斜杠 - 目录名大小写不一致（如
src/logger/但命名空间写MyPackageLogger）——Linux 环境直接加载失败 - 修改了
composer.json中的psr-4映射后，没运行composer dump-autoload——旧映射仍生效，新类永远不被识别
模块间依赖要显式声明，不能靠“我知道它在 vendor 里”
模块 A 想用模块 B 的能力，不能写 use SomeOtherPackageBService; 然后指望主项目装了那个包就行。这会让你的包变成“隐式依赖”，下游项目安装时可能因版本冲突或漏装而崩。
正确方式是：把模块 B 的能力抽象成接口，放在当前包内（如 MyPackageContractsReporter），再让使用者传入实现。或者，如果模块 B 是你维护的另一个 Composer 包，就在 composer.json 的 require 里明写 "myvendor/b-module": "^1.2"。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
注意性能影响：过度拆包会导致 vendor/ 层级变深、类加载路径变长；但过度合并又导致无法按需引入。折中方案是：一个包最多暴露 3–5 个核心模块，其余内部细节隐藏在 src/Internal/ 下，并加 @internal 注解。
本地开发时用 path 仓库，别碰 dev-master
模块化开发必然涉及多包联调。此时别用 "dev-master" 或 "@dev" 这种模糊版本号，它会让 Composer 缓存远程包快照，你改了本地代码却看不到效果。
必须用 path 类型仓库：
{
"repositories": [
{
"type": "path",
"url": "../my-package-logger"
}
],
"require": {
"myvendor/logger": "*"
}
}
这样 Composer 会在安装时创建符号链接，你改 ../my-package-logger/src/ 里的代码，主项目立刻生效。但要注意：path 仓库不支持版本约束（如 "^2.0"），* 是唯一合法值；而且一旦发布到 Packagist，就得切回正常版本依赖，否则别人装不上。
最容易被忽略的一点：多个本地包互相依赖时，每个包的 composer.json 都得配自己的 path 仓库，不能只在主项目里配——否则 Composer 解析依赖图时会找不到上游包。
