结论是可行但必须完成装对、路径加对、验证对三步；根本原因是全局可执行文件所在路径（Linux/macOS为~/.composer/vendor/bin，Windows为%APPDATA%\Composer\vendor\bin）未加入系统PATH，导致命令无法被定位。
直接说结论：用 composer global require 安装 PHP 代码质量工具（如 phpmd、phpcs、phpstan）可行，但必须做完三件事——装对、路径加对、验证对；漏任何一步，IDE 或终端里都只会报 command not found 或 Permission denied。
为什么装完还是找不到 phpmd / phpcs 命令
根本原因不是没装上，而是系统压根不知道去哪找它。Composer 全局安装的可执行文件实际放在：~/.composer/vendor/bin（macOS/Linux）或 %APPDATA%\Composer\vendor\bin（Windows），这个路径默认不在 $PATH 里。
- 运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认输出里含上述路径 - 没出现？那就得手动加：编辑
~/.zshrc（macOS Catalina+ 默认 shell）或~/.bashrc，追加一行：export PATH="$HOME/.composer/vendor/bin:$PATH" - 改完别忘了
source ~/.zshrc（或对应文件），否则新终端才生效 - Windows 用户注意：
phpcs.bat和phpmd.bat是真实可执行文件，CMD/PowerShell 必须重启才能识别新 PATH
composer global require 报 Permission denied 怎么办
这是最典型的权限陷阱——用了 sudo composer global require。结果是二进制文件被写进 /root/.composer/vendor/bin，普通用户根本无权读取，后续所有 global 命令都会失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 立刻停止用
sudo执行composer global类命令 - 删掉错误安装的残留：
sudo rm -rf ~/.composer/vendor（先备份必要配置） - 重置 Composer 权限：
composer global diagnose会提示目录权限问题，按建议修复（通常是chmod -R u+rw ~/.composer） - 再重新跑
composer global require phpmd/phpmd，不加sudo
PhpStorm 里 PHPMD / PHPCS 配置总验证失败
验证失败 ≠ 工具没装好，大概率是 PhpStorm 指向了错误路径，或者 PHP 版本不兼容。
- 在终端里先确认命令可用：
phpmd --version和phpcs --version都得有输出 - PhpStorm 中设置路径时，必须选中具体可执行文件：
~/.composer/vendor/bin/phpmd（Linux/macOS）或%APPDATA%\Composer\vendor\bin\phpmd.bat（Windows），不能只选目录 - 点击
Validate后若提示 “PHP version mismatch”，说明 PhpStorm 内置 PHP 解释器版本（Settings → PHP → CLI Interpreter）低于工具要求（例如 PHPMD 3.x 需 PHP 8.0+） - 某些旧版 PhpStorm 对
.bat文件调用不稳定，Windows 用户可尝试用 WSL2 下的phpmd路径替代
该全局装还是项目内装
看工具用途：跨项目通用的 CLI 工具（phpmd、phpcs、grumphp）适合全局；但像 phpstan 这类需与项目 PHP 版本强绑定的，建议项目内装（composer require --dev phpstan/phpstan）。
- 全局装的好处：一次配置，所有项目复用；适合 IDE 集成和日常开发检查
- 项目内装的好处：版本锁定精准，CI 流水线更可控；避免团队成员因全局版本不一致导致检查结果差异
- 折中方案：全局装
phpcs+phpmd供 IDE 实时提示；项目内装phpstan+psalm做 CI 深度扫描
真正容易被忽略的是：全局 bin 目录权限被 macOS 的 SIP 或 Linux 的 umask 拦截后，连 ls -l ~/.composer/vendor/bin 都可能看不到文件——这时候得先查 composer global config home 确认真实安装位置，再检查父目录读写权限。
