--clean-id 是无效参数，composer 官方从未定义；常见误因是混淆 clear-cache、git 命令或拼写错误；真实需求应通过切官方源、清缓存、重装或检查路径解决。
composer self-update --clean-id 不存在，是无效命令。Composer 官方文档、源码及所有已知版本（截至 2026 年 5 月）均未定义 --clean-id 参数，执行该命令会直接报错：Command "self-update" is not defined. 或提示未知选项。
为什么有人误以为有 --clean-id？
常见混淆来源包括：
- 把
composer clear-cache的--no-interaction误记为--clean-id - 将 Git 的
git clean -fdx或某些私有插件的自定义参数套用到 Composer - 看到过时的社区帖子或拼写错误的 CI 脚本（例如把
--clean-cache手误写成--clean-id）
真正需要“清理标识符”时，实际要解决什么问题？
用户想用 --clean-id，往往真实诉求是以下之一：
- 避免因本地缓存/签名校验失败导致
self-update卡住或降级异常 - 清除旧版 GPG 签名验证残留（Composer 2.2+ 默认启用）
- 重置被污染的全局配置（如镜像源指向已下线地址）
- 解决多版本共存时
which composer和实际执行路径不一致的问题
对应场景的正确操作
别碰不存在的 --clean-id，按需选以下方案：
- 升级前清缓存 + 切官方源：
composer config -g repo.packagist composer https://packagist.org && composer clear-cache --no-interaction - 强制绕过 GPG 校验（仅调试用，不推荐长期）：
composer self-update --no-gpg-checks（Composer ≥ 2.2.14 支持） - 彻底重装并指定路径（最干净）：
php -r"copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php --install-dir=$HOME/bin --filename=composer && rm composer-setup.php - 查清当前调用的是哪个二进制：
which composer和ls -l $(which composer)，确认是否是软链接或 wrapper 脚本
真正麻烦的不是加错参数，而是更新后 composer install 报 Plugin 加载失败、content-hash 缺失或锁文件格式不兼容——这些都和主版本跃迁（如 v2 → v3）强相关，和所谓“ID”无关。升级前先看 composer --version 和项目 composer.lock 里 platform 字段，比找不存在的开关实在得多。
