composer install 不触发中文包配置，因其不区分中英文包，只依据 composer.json 中 type 字段（如 symfony-bundle）及是否含 flex 配方；纯库仅下载代码与生成 autoload，无自动配置；需手动或通过 post-autoload-dump 事件执行初始化。
composer install 为什么没触发中文包的配置？
因为 Composer 不区分“中文包”或“英文包”，它只认 composer.json 里声明的 type 和是否带配方（recipe）。如果你装的是一个纯 PHP 库（比如 yiisoft/yii2 或某个国内团队发布的 acme/wechat-sdk），而它没在 Packagist 注册配方，那 composer install 就只是下载代码、生成 autoload 映射，不会自动改配置、建目录、写 .env —— 这些动作得靠 Flex 配方或你手动脚本。
- 确认该包是否声明了
"type": "symfony-bundle"或"type": "library"：只有明确标记为symfony-bundle且有对应配方时，Flex 才会自动执行configure() - 检查包的仓库根目录下是否有
symfony/recipes/<vendor>/<package>/</package></vendor>路径：没有就说明无官方配方 - 中文包若用私有源（如 Nexus/Satis）发布，需确保其
packages.json中的dist或source字段路径可访问，否则install会卡在下载阶段
post-autoload-dump 是中文包运行时初始化的唯一可靠时机
很多中文 SDK（比如支付、短信、OCR 类包）需要在类加载就绪后注册全局钩子、初始化连接池或加载本地词典文件。但 post-install-cmd 不稳定，post-package-install 只对直连依赖生效 —— 唯一每次 composer install/update 都必跑、且能保证 autoloader 已生成的事件是 post-autoload-dump。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 它不加载项目 autoloader，所以不能直接 new 自定义类；必须显式
require初始化脚本，例如：php -f vendor/acme/sms-sdk/bin/init.php - 如果初始化逻辑依赖 Doctrine 或 Symfony Container，别硬塞进事件脚本，改用
php bin/console acme:sms:setup方式调用 - 注意：该事件在 CI 中可能因缓存跳过 autoload 重建，导致不触发；加
--no-cache或强制composer dump-autoload可规避
废弃中文包时，composer audit 不会自动识别非 Packagist 包
composer audit --abandoned 默认只查 Packagist 元数据，对走私有源（repositories.type=composer）的中文包完全无感知。即使你在自己包的 composer.json 里写了 "abandoned": "acme/new-sms-sdk"，Composer 也不会在 install 时打印警告。
- 解决方案：在私有源的
packages.json中，为废弃包手动添加abandoned字段（Satis 支持，Nexus 需插件） - 更实际的做法：在根项目
composer.json的config.audit.ignore-abandoned里留空，然后用脚本扫描vendor/目录下所有包的composer.json，grep"abandoned"字段 - CI 流水线中可加校验：
find vendor -name composer.json -exec grep -l '"abandoned":' {} \;，发现即失败构建
中文包版本漂移常因 lock 文件未提交或平台约束缺失
国内不少团队用中文包时忽略 composer.lock 提交，或没写 platform.php，结果开发机 PHP 8.2 装的包，在线上 PHP 8.1 环境直接报 Class not found —— 不是包坏了，是依赖树在不同 PHP 版本下解析出不同结果。
- 必须把
composer.lock提交进 Git：它不是“临时文件”，而是环境一致性的契约 - 在
composer.json的config.platform下明确声明："php": "8.1.0"，防止本地高版本 PHP 解析出不兼容的依赖 - 中文包若含 C 扩展依赖（如
ext-gmp或ext-redis），需在config.platform中一并声明，否则composer install可能绕过兼容性检查
