运行 composer 不显示命令列表时，必须用 composer --help 或 composer list；require 是运行时依赖，require-dev 仅开发使用；日常用 install 还原 lock 文件，update 重解析依赖；autoload.php 失败主因是 vendor 缺失、路径错误或 php 版本不匹配。
composer命令查不到 help 选项怎么办
运行 composer 不显示可用命令列表，大概率是没加 --help 或者用了错的参数。Composer 的帮助系统不响应空命令或 -h（部分旧版本不支持），必须用 composer --help 或 composer list 才能列出全部子命令。
常见错误现象：
- 直接敲
composer回车 → 只显示版本号和 usage 提示，不列命令 - 运行
composer -h→ 报错Unrecognized option "-h"（尤其在较老的 Composer 2.0 之前版本） - 误输
composer help（没加--）→ 提示Command "help" is not defined
正确做法：
-
composer --help：显示全局选项 + 所有内置命令名 -
composer list：等价于上面，更直观，推荐日常使用 -
composer require --help：查具体命令的参数、别名、选项说明 -
composer show --help：比如想确认--all和--installed的区别，就得这么查
composer.json 里 require 和 require-dev 的区别在哪
这两个字段都写依赖，但作用域和安装行为完全不同，混淆会导致生产环境多装一堆调试工具，或者本地跑不起来测试代码。
关键差异：
-
require：运行时必需的库，composer install默认只装它；上线部署必须保留 -
require-dev：仅开发阶段需要的包，比如phpunit/phpunit、phpstan/phpstan；执行composer install --no-dev会跳过它们 - 如果项目中用了
autoload-dev配置，对应路径下的类只在开发环境下自动加载，生产环境不可见 -
composer update默认同时更新require和require-dev；加--no-dev才跳过后者
容易踩的坑：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 把
symfony/var-dumper写进require→ 生产环境也会加载 dump() 函数，有安全风险 - CI 流水线没加
--no-dev→ 构建镜像体积变大，还可能因 dev 包触发额外 autoload 规则导致性能下降
composer install 和 composer update 到底该用哪个
一句话判断：composer install 是“按 lock 文件还原”，composer update 是“重新解析并升级依赖”。90% 的日常开发场景应该用 install。
使用场景对比：
- 第一次拉下项目代码 → 必须用
composer install（没有composer.lock时会自动生成） - 团队协作、CI/CD 构建、线上部署 → 只能用
composer install，确保所有人装的版本完全一致 - 要升级某个包（如
monolog/monolog）到新主版本 → 先改composer.json中的版本约束，再运行composer update monolog/monolog - 想批量更新所有包到最新兼容版本 →
composer update，但务必先提交当前composer.lock，否则无法回滚
性能与风险提示：
-
update会重新走一遍依赖求解（solver），耗时长，尤其在大型项目中可能卡住几秒到几十秒 -
update可能引入破坏性变更（BC break），即使版本号符合^2.0约束，也建议搭配composer outdated先看哪些包可安全升级 - 没有
composer.lock时，install行为等同于update，但不会生成 lock 文件 —— 这属于配置缺失，不是正常流程
vendor/autoload.php 加载失败的常见原因
报错 Warning: require(vendor/autoload.php): failed to open stream 或 Fatal error: Uncaught Error: Class 'Monolog\Logger' not found，基本就这三类问题。
排查顺序：
- 确认
vendor目录是否存在，且里面有autoload.php—— 如果没有，说明composer install没成功运行，或被.gitignore误删了 - 检查 require 路径是否写错：用
__DIR__ . '/vendor/autoload.php'，不要硬写相对路径如../vendor/autoload.php，容易因执行位置不同而失效 - 确认 PHP 版本满足依赖要求：比如某包声明
"php": "^8.1"，但服务器是 PHP 7.4，composer install会静默跳过 autoload 生成（可通过composer diagnose发现） - 如果用了自定义 autoloader（如 PSR-4 映射），检查
composer.json中autoload字段拼写是否正确，key 必须是"psr-4"，不是"psr4"或"PSR-4"
最容易被忽略的一点：某些 IDE 或部署脚本会清理空目录，而 vendor 下某些包的 tests/ 或 docs/ 目录为空，被误删后可能触发 Composer 的 autoload 重生成失败 —— 建议在 composer.json 中加 "optimize-autoloader": true 并运行 composer dump-autoload -o 生成优化版映射。
