composer help 不显示内容通常因不在含 composer.json 的项目目录，应进入项目根目录或用 composer list 查全局命令；查具体命令选项需指定子命令如 composer help install；参数过滤可用 grep 或 findstr；部分选项如 --no-cache 有隐含行为，文档未详述。
composer help 不显示任何内容？先确认是否在项目根目录
很多情况下执行 composer help 没反应或报错，不是命令失效，而是当前路径没找到 composer.json 或未初始化 Composer 环境。Composer 的帮助系统依赖本地配置和已加载的命令插件，不在有效项目目录时部分子命令可能不显示。
- 进入含
composer.json的目录再试（哪怕只是空文件） - 如果纯想查全局可用命令，直接运行
composer list更可靠，它不依赖项目上下文 - 某些自定义命令（比如
laravel/installer提供的）只在安装后且有 autoload 配置时才出现在help列表里
想查某个具体命令的用法，别只输 composer help
composer help 默认只列出顶层命令，真正有用的细节藏在子命令后面。比如你想知道怎么跳过脚本执行，得查 install 命令本身的选项，而不是泛泛看帮助首页。
- 查完整参数：例如
composer help install，会显示所有开关（--no-scripts、--ignore-platform-reqs等） - 参数说明里常混着兼容性提示，比如
--with-all-dependencies在 Composer 2.2+ 才支持，旧版本会忽略 - 有些选项仅对特定命令生效，像
dump-autoload的--optimize在 PHP 8.1+ 下效果更明显，但文档不会主动提醒这点
help 输出太长看不过来？用管道过滤关键词
默认输出包含所有内置命令 + 插件命令，动辄上百行。实际你往往只关心某类行为，比如“怎么强制重装”或“怎么指定镜像源”。
- 快速定位常用选项：
composer help require | grep -i "dev\|prefer" - 查镜像相关：
composer help config | grep -E "(repo|mirror)" - Windows 用户注意：
findstr替代grep，语法略有不同，比如composer help update | findstr /i "lock"
为什么 help 里没写清楚 --no-cache 是干啥的？
Composer 官方帮助文本对部分高级开关描述极简，甚至完全省略副作用说明。--no-cache 就是典型——它不只是“不读缓存”，还会跳过整个 composer cache 目录的校验逻辑，影响后续 create-project 的速度和包完整性验证。
- 该选项在 CI 环境中常用，但本地开发慎用，尤其当你频繁切换分支时容易触发重复下载
- 它不等价于清空缓存（那是
composer clear-cache），而是临时绕过缓存层 - 某些私有仓库配置下，
--no-cache可能导致认证失败，因为缓存里存了临时 token
这类隐含行为几乎不会出现在 composer help 输出里，得翻 GitHub 上的 issue 或源码里的注释才能确认。
