推荐项目级安装而非全局：composer require --dev squizlabs/php_codesniffer，因版本锁在composer.json、CI/CD开箱即用、避免多项目PHPCS版本冲突，且phpcs自动读取项目根目录phpcs.xml规则。
直接装 composer global require squizlabs/php_codesniffer 很容易卡在“命令找不到”或“Permission denied”，不是 PHPCS 有问题，而是全局 bin 路径没进 PATH，或者权限错乱了。
phpcs 命令报 “command not found” 或 “Could not open input file”
这是最常见现象，本质是系统根本没找到 phpcs 可执行文件。
- Linux/macOS 下运行
composer global config bin-dir --absolute，确认输出路径（通常是~/.composer/vendor/bin），再检查echo $PATH是否包含它；没包含就加到~/.zshrc或~/.bashrc里：export PATH="$HOME/.composer/vendor/bin:$PATH"，然后source ~/.zshrc - Windows 用户重点查
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin是否进了系统环境变量的Path（不是用户变量） - 别用
sudo composer global require—— 后续所有global操作都会因权限不一致失败，改用chown -R $USER ~/.composer修复归属权 - 验证是否生效：终端直接输
phpcs --version，能输出版本号才算通
为什么推荐项目级安装而非全局
团队协作和 CI/CD 场景下，全局安装反而增加不确定性。
- 项目级命令是
composer require --dev squizlabs/php_codesniffer，二进制落在vendor/bin/phpcs，路径固定、版本锁死、Git 可见 - CI 脚本里写
./vendor/bin/phpcs --standard=PSR12 src/，不用依赖任何环境配置 - 不同项目可能要求 PHPCS 4.0 和 3.7，全局只能存一个版本，容易误伤老项目
-
phpcs执行时自动读取项目根目录的phpcs.xml，全局安装容易漏配或读错配置
装完后 run 不起来，提示 “No ruleset found”
这不是安装失败，是没告诉 PHPCS 用哪套规则 —— 它默认不带任何规则集。
立即学习“PHP免费学习笔记（深入）”；
- 先运行
phpcs -i，确认输出里有PSR12、Generic等 standard 名称（注意大小写：--standard=psr12会失败） - 检查单个文件必须显式指定规则：
phpcs --standard=PSR12 src/MyClass.php - 想设默认规则，就在项目根目录建
phpcs.xml，内容至少含<rule ref="PSR12"/>，之后直接phpcs src/就生效 - PHP 8.3+ 环境下若报
Warning: Undefined array key，大概率是 PHPCS 版本太低，运行composer update squizlabs/php_codesniffer --with-dependencies升到 4.x
真正麻烦的从来不是“怎么装”，而是装完后命令路径、规则集、PHP 版本三者没对齐。尤其当多个项目共用一个开发机时，全局安装带来的隐性冲突远比多打几个 ./vendor/bin/ 前缀要难排查。
