Composer没有--channel参数，有效通道控制参数为--stable、--preview、--snapshot和--3；--channel是常见误解，源于混淆镜像源配置与版本更新机制。
composer self-update --channel 无效？别试了，这个参数根本不存在
Composer 没有 --channel 这个参数，所有搜到“切换 channel”的教程，基本都混淆了旧版别名、第三方插件或镜像源配置。真正控制更新目标的，是 --stable、--preview、--snapshot 和 --3 这类显式通道标识，不是靠一个通用 --channel 开关。
如果你运行 composer self-update --channel stable 报错 Command "self-update" is not defined 或提示未知选项，就是因为它压根不支持该语法——连 composer self-update --help 的输出里都找不到 --channel。
真正有效的通道控制：--stable、--preview、--snapshot、--3
Composer 用参数直接指定更新目标，而不是“设置一个 channel 后再 update”。每个参数对应明确的行为边界：
-
composer self-update --stable：升到当前主版本（如 v2）下最新稳定小版本，等价于不加参数的默认行为 -
composer self-update --preview：拉取最新 beta/RC 版本（如3.0.0-RC1），适合测试兼容性，但生产环境慎用 -
composer self-update --snapshot：下载每日构建版（dev build），仅用于调试底层问题，无稳定性保障 -
composer self-update --3：强制升级到 v3 主干（需 Composer ≥ 2.5+），不是“切 channel”，而是声明主版本跃迁
注意：--3 不是 --channel=3，也不能和 --preview 组合使用（如 --preview --3 会报错）。v3 的预发布版单独走 --preview，正式 v3 则用 --3。
为什么有人误以为有 --channel？其实是 config repo.packagist 干的
混淆常来自 composer config -g repo.packagist 这个命令，它改的是包下载源（即 packagist 镜像），和 self-update 无关。比如：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/→ 影响composer install时包从哪下 -
composer self-update→ 始终从https://getcomposer.org/download/拉 PHAR，完全绕过这个配置
所以你把 repo.packagist 设成腾讯云镜像，对 self-update 是否成功毫无影响；但若该镜像缓存了 https://getcomposer.org/ 的响应（部分老旧镜像确实这么干），就会导致 Up to date 误判——这不是通道问题，是代理污染。
想看当前支持哪些通道和版本？用 --list
composer self-update --list 是唯一能列出可选目标的命令，但它只在 Composer ≥ 2.5+ 中可用。输出类似：
Available versions: 2.x (stable channel) 3.x (preview channel) 3.0.0-RC2 (preview) 2.7.7 (stable)
这里所谓 “channel” 是 Composer 内部对发布策略的描述，不是用户可配置的开关。你不能用它来“切换”到某个 channel 再 update，只能从中挑一个具体目标，然后用对应参数触发：
- 要 v2 最新版 →
composer self-update --stable或composer self-update 2.7.7 - 要 v3 正式版 →
composer self-update --3（前提是已 ≥ 2.5+） - 要 v3 RC →
composer self-update --preview（它会自动选最新 RC）
最易忽略的一点：执行完任何 self-update 后，务必跑一次 composer --version 看 commit hash 和日期，别只信终端那句 “Updated”。PATH 冲突、Windows 缓存、Docker 只读层，都可能让新二进制根本没被 shell 加载。
