直接composer require php-parallel-lint/php-parallel-lint虽可安装，但因其是纯CLI工具而非PHP库，不提供可use的类，仅生成vendor/bin/parallel-lint二进制文件，须通过php vendor/bin/parallel-lint调用，不可实例化使用。
为什么直接 composer require 会失败
PHP-Parallel-Lint 不是传统意义上的“库”，它本身不提供可被 require 的类或命名空间，而是一个命令行工具。直接运行 composer require php-parallel-lint/php-parallel-lint 虽然能装上，但你没法在 PHP 代码里 use 它——因为压根没设计成 SDK 使用方式。
它的核心价值在 CLI：并行扫描 PHP 文件、快速报出语法错误（比如 Parse error: syntax error, unexpected '}'），特别适合 CI 环境做预检。
- 装完后二进制文件默认放在
vendor/bin/parallel-lint - 必须通过
php vendor/bin/parallel-lint启动，不能new ParallelLint() - 某些 CI 镜像（如
php:8.2-cli）默认没装zip扩展，会导致composer install失败——得先docker-php-ext-install zip
CI 中调用 parallel-lint 的最小可行命令
别写一堆封装脚本，CI 里最稳的方式就是直调二进制。以下命令已验证在 GitHub Actions、GitLab CI、Jenkins 上通用：
php vendor/bin/parallel-lint --exclude vendor --exclude tests --no-color ./src ./tests
-
--exclude vendor必加，否则会扫整个vendor/目录，既慢又可能因第三方代码报错中断构建 -
--no-color推荐加上，避免 ANSI 控制字符污染 CI 日志，影响错误定位 - 路径参数要显式列出（如
./src），不能只写.—— 否则会误扫composer.json、.git/等非 PHP 文件，触发Warning: file_get_contents(...): failed to open stream - 如果项目用 PHP 8+ 语法但 CI 环境是 PHP 7.4，
parallel-lint会按当前 PHP 版本解析，导致误报；需确保 CI 的 PHP 版本 ≥ 项目最低要求
如何让 parallel-lint 在语法错误时真正失败 CI
默认行为是：有错误就输出红字，但进程退出码仍是 0（即“成功”），CI 就不会中断。必须靠 --show-deprecated 以外的机制强制失败。
立即学习“PHP免费学习笔记（深入）”；
- 加
--check参数：这是关键。它会让命令在发现任何语法错误时返回非零退出码（通常是1） - 完整推荐命令：
php vendor/bin/parallel-lint --check --exclude vendor --no-color ./src
- 不加
--check时，即使满屏Parse error，CI 仍显示 ✅；加了之后，第一个错误就exit 1 - 注意：旧版
php-parallel-lint（v1.x）不支持--check，必须升到 v2.0+；检查方式：php vendor/bin/parallel-lint --version
常见误配和静默失效点
很多团队配完跑了一阵子“没问题”，某天突然不报错了——大概率踩了下面这些坑：
-
composer.json里把php-parallel-lint/php-parallel-lint放在require-dev没问题，但 CI 脚本里漏了composer install --no-interaction --prefer-dist，导致vendor/bin/parallel-lint根本不存在 - 用了
composer install --no-dev（常见于生产镜像复用场景），那parallel-lint就不会被安装 - 路径写成
src/（无点斜杠），在某些 shell 下会被解释为相对当前工作目录，而 CI 工作目录可能不是项目根，结果扫了个空目录 - 文件编码含 BOM（尤其 Windows 下编辑的
.php），parallel-lint会直接报Parse error: syntax error, unexpected '' (T_STRING)，但不提示是 BOM 导致——得手动用file -i src/File.php查编码
最保险的做法：CI 启动后第一行加 ls -l vendor/bin/parallel-lint || echo "parallel-lint missing!" && exit 1，先确认工具存在再执行扫描。
