“Command ‘xxx’ is not defined” 是命令拼写错误或类型误判，非模块缺失；需通过 composer list 确认命令归属（内置/脚本/插件），排查权限污染与 Composer 版本兼容性。
“Command ‘xxx’ is not defined” 是拼写或类型误判，不是模块缺失
这个报错根本不是 PHP 模块没装、也不是 Composer 插件没启用，而是你输了一个它根本不认识的命令。比如 composer dump-autoloads（多了个 s）、composer install-deps（不存在的别名），或者把自定义脚本当内置命令用了。
常见误操作包括：
- 把
composer run build简写成composer build—— 后者必然报 “Command not defined” - 把第三方插件命令（如
composer normalize）当成默认命令，但其实还没安装ergebnis/composer-normalize - 在旧版 Composer（v1）里用了 v2 才支持的命令，比如
composer validate --no-check-publish
确认命令是否属于内置、脚本或插件
先跑 composer list，看输出里有没有你要用的命令。没有就说明三件事之一：
- 它是项目级自定义脚本 → 查
composer.json的"scripts"字段，然后用composer run xxx - 它是全局插件命令 → 运行
composer global list，若没出现，需先composer global require vendor/package-name - 它是本地插件命令 → 检查
require-dev里是否含对应插件，再确认是否执行过composer install安装了它
别直接搜“Composer xxx 模块未定义”，这词根本不存在——Composer 没有“模块”概念，只有命令、脚本、插件三类可执行入口。
权限污染导致命令加载失败（容易被忽略）
如果你之前用过 sudo composer global require，很可能已把全局 bin 目录污染成 root 所有，导致普通用户运行 composer 时无法加载已安装的插件命令。现象是：composer global list 显示为空，哪怕你明明 global require 过。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
验证方式：
- 运行
composer config --global home，如果输出是/root/.composer或权限为root:root，就是污染了 - 临时绕过：加环境变量运行
COMPOSER_HOME=$HOME/.composer composer global list - 彻底修复：删掉
/root/.composer（如有），然后所有global命令都不加sudo
这个点不排查，你重装十次插件都没用——命令根本没机会被加载。
Composer 版本不匹配引发命令不可用
某些命令只在特定版本存在。例如 composer outdated --direct 在 v2.2+ 才支持，v2.1 会报 “Command not defined”。同理，composer remove 是 v2.2 新增命令，旧版不识别。
检查当前版本：
-
composer --version→ 看是否低于文档要求的最低版本 - 升级：
composer self-update（推荐）或sudo composer self-update（仅当你确认全局目录归属正确时） - 降级回滚（必要时）：
composer self-update --rollback
v2.5+ 已移除部分实验性命令，如果依赖某个已被弃用的命令，得改用替代方案，而不是硬等“模块恢复”。
