正确命令是 composer require laravel/pint --dev，它将 Pint 作为开发依赖写入 require-dev 区块；禁用全局安装，需确保 PHP ≥8.1、symfony/console 版本兼容，并通过 vendor/bin/pint --version 验证。
Composer 安装 Laravel Pint 的正确命令是什么？
直接运行 composer require laravel/pint --dev 即可。这是当前（Laravel Pint v1.x）最稳定、兼容性最好的安装方式，会把 Pint 作为开发依赖写入 composer.json 的 require-dev 区块。
注意：不要用 composer global require laravel/pint —— 全局安装会导致项目间规则冲突、PHP 版本错配，且无法被 composer.lock 锁定版本，CI/CD 构建时极易失败。
- 如果项目已锁定 PHP 版本（如
"php": "^8.1"），Pint 会自动匹配对应兼容版本（v1.13+ 支持 PHP 8.1–8.3） - 安装后二进制文件路径为
vendor/bin/pint，不是./pint或全局pint - Windows 用户需确保
vendor\bin在系统 PATH 中，或改用php vendor/bin/pint
为什么 composer require laravel/pint 会报错？
常见错误是 Your requirements could not be resolved，本质是版本约束冲突。Pint 依赖 laravel/pint 自身的 PHP 和扩展要求（如 ext-json, ext-mbstring），也间接依赖 symfony/console 等组件。
典型触发场景：
- 项目已引入旧版
symfony/console:^5.4，而 Pint v1.14 要求^6.0→ 解决：升级 Symfony 组件，或降级 Pint（composer require laravel/pint:^1.12 --dev） - PHP 版本低于 8.1 → 检查
php -v，Pint 不支持 PHP 7.x 或 8.0 - 本地启用了
platform-check但composer.json未声明config.platform.php→ 补上"config": {"platform": {"php": "8.1.0"}}
安装后怎么立刻检查是否生效？
运行 vendor/bin/pint --version。输出类似 v1.13.5 即表示安装成功且可执行。
别急着格式化代码 —— 先确认当前目录下有 pint.json 或 pint.json.dist 配置文件。没有的话，Pint 会按 Laravel 默认规则走，但可能和团队期望不一致。
- 首次使用建议先生成默认配置：
vendor/bin/pint --init（会创建pint.json） - 想看具体哪些文件会被修改？加
--dry-run参数：vendor/bin/pint --dry-run - 只检查不修改，用
--test；CI 中推荐该模式，退出码非 0 表示存在不规范代码
CI 流程中调用 Pint 为什么总失败？
根本原因是没在 CI 环境里运行 composer install --no-interaction --prefer-dist，导致 vendor/bin/pint 根本不存在。
关键点：
- CI 脚本中必须确保
composer install成功完成，且未跳过dev依赖（即不能加--no-dev） - GitHub Actions 示例中，别写
run: pint --test，而应写run: vendor/bin/pint --test - GitLab CI 若用
image: php:8.2，需提前装好zip扩展（Pint 内部依赖），否则报Class 'ZipArchive' not found
最易被忽略的是：Pint 的规则集（如 psr12）在不同 minor 版本间可能微调，务必用 composer.lock 锁死版本，而不是靠 ^1.13 这类松散约束。
