最可靠中文资源是社区维护的《composer 中文文档》(github.com/521xueweihan/composer-docs),它同步官方 v2.5.x、字段带注释与示例;php 手册 composer 章节和 packagist 中文镜像页为辅;切勿轻信标榜“官网”的过时静态镜像。

Composer 官方中文文档早已停止维护,目前最可靠、更新及时的中文资源是社区持续维护的《Composer 中文文档》(非官方但质量高),而不是搜索结果里排第一的过时镜像站。
为什么不能信“Composer中文官网”或百度前几页的文档
很多标着“Composer中文文档”的网站实际是 2018 年前的静态快照,composer create-project 的参数说明缺失 --stability 和 --remove-vcs,config 命令的 secure-http 默认值写错成 false(实际从 Composer 2.0 起默认为 true)。这类文档查到报错再回头翻英文,反而拖慢进度。
推荐的三个实操向中文资源
以下按「查得快、改得准、不踩坑」排序:
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
Composer 中文文档(github.com/521xueweihan/composer-docs):基于官方英文文档 v2.5.x 同步翻译,
composer.json所有字段都带中文注释和最小可运行示例,比如autoload下的psr-4和classmap区别用两行代码就讲清 -
PHP 官方手册 Composer 章节(php.net/manual/zh/book.composer.php):虽非独立文档,但 PHP 手册中「安装与配置」和「常见问题」两节由国内核心贡献者维护,重点解释
vendor/autoload.php加载机制和COMPOSER_HOME环境变量的实际影响路径 -
Packagist 中文镜像使用页(https://packagist.phpcomposer.com):注意这不是文档,而是实操入口——它直接给出
composer config -g repo.packagist composer https://packagist.phpcomposer.com这条命令,且明确标注「仅适用于 Composer 1.x」;用 Composer 2.x 会报Invalid repository type: composer错误
遇到文档没写清楚时,优先查什么
中文资料常省略底层行为,比如 composer update 为什么有时重装整个 vendor,有时只更新一个包。这时应:
- 看
composer show --platform输出的 PHP 和扩展版本,确认是否触发了platform-check机制 - 检查
composer.lock里content-hash字段是否变化,变化说明composer.json的require或autoload有改动 - 运行
composer update -v(不是-vvv),观察最后三行日志里是否出现Resolving dependencies through SAT—— 出现即表示启用了依赖求解器,耗时长是正常的,不是卡死
真正容易被忽略的是:composer dump-autoload 在开发阶段比 update 更常用,但它不会更新 composer.lock,也不会检查远程包版本。很多人改完 autoload 配置后直接跑测试失败,却去怀疑 PSR-4 命名规则,其实只是忘了执行这一步。










