composer 不支持中文包名，所有包名必须为 ascii 字符；所谓“中文包名”实为 description 注释、第三方翻译插件或渲染异常所致，真实依赖分析应依赖 composer show、--tree、why 等命令获取结构化元数据。
Composer 本身不支持中文包名，所有包名必须是 ASCII 字符，所谓“中文包名”实际是开发者在 composer.json 的 description、name 注释或文档里写的中文说明，不是 Composer 解析或依赖图谱中的合法标识。
为什么你看到的“中文包名”其实是假象
Composer 的包命名规范强制要求 vendor/name 格式为小写字母、数字、下划线和连字符（如 monolog/monolog），不接受中文字符。如果你在终端或 IDE 中看到类似“日志组件”这样的字样，大概率来自以下三种情况之一：
- 你在
composer.json的description字段手动写了中文，比如"description": "日志组件封装"，但composer show默认不显示该字段 - 你安装了第三方语言包插件（如
csineneo/lang-simplified-chinese），它把英文输出翻译成中文——但这会干扰脚本解析、CI/CD 日志识别，且 Composer 官方不维护也不推荐 - 你的编辑器或终端对 UTF-8 渲染异常，把某些 ASCII 符号误显示为中文形近字（极少见，但 Windows PowerShell + 某些字体时可能发生）
想辅助架构设计分析，真正有用的是结构化元数据，不是中文名称
架构设计需要的是可追溯、可筛选、可比对的依赖关系，而非视觉上的“中文友好”。你应该聚焦以下真实可用的信息源：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
composer show -s vendor/package-name查看autoload映射，确认该包是否暴露接口、提供服务类、是否支持 PSR-4 自动加载 - 用
composer show --tree vendor/package-name看清它拉入了哪些底层能力（比如是否引入了ext-curl、symfony/polyfill等隐式运行时依赖） - 用
composer why vendor/package-name定位它被谁引入、是否属于 dev-only 工具链（如phpunit/phpunit）、是否能安全移除 - 用
composer show --all vendor/package-name对比远程所有版本，判断是否卡在旧版、是否存在 LTS 或安全修复分支
如果非要“中文标注”，建议用外部方式打标签，而不是改包名
强行把中文塞进包名会导致 composer install 失败、Git 提交混乱、私有仓库同步异常。更稳妥的做法是：
- 在项目根目录维护一个
ARCHITECTURE.md文件，用表格列出关键包的中文用途、负责人、替换成本评估，例如：monolog/monolog → 日志门面封装｜高｜已抽象为 Psr\Log\LoggerInterface - 用
composer.json的scripts添加自定义命令，比如"arch:explain": "echo '日志组件：monolog/monolog → symfony/console → psr/log'"，便于团队快速理解 - 导出依赖树后用脚本做二次标注：
composer show --tree | grep -E "(monolog|psr/log)" | sed 's/monolog\/monolog/【日志核心】monolog\/monolog/g'，仅用于临时报告，不进版本库
依赖图谱的价值在于精确性，不是可读性。中文描述可以加在文档、注释或 CI 报告里，但绝不能污染 composer.lock 或包注册名——后者一旦出错，整个依赖解析都会失效。
