必须本地安装而非全局安装，因parallel-lint语法检查依赖php解析器版本且有硬性版本要求（如v1.4+需php 8.0+），全局单版本易导致跨项目parseerror、ci报command not found及lint结果不一致。
直接用 composer require --dev php-parallel-lint/php-parallel-lint 装进项目本地，别全局装——PHP 版本不一致时，全局版本会悄悄错杀文件，CI 报错却本地跑得通，这种问题排查起来最耗时间。
为什么必须本地安装而不是全局
parallel-lint 的语法检查行为依赖当前 PHP 解析器版本，而它本身又对 PHP 版本有硬性要求（比如 v1.4+ 强制需 PHP 8.0+）。不同项目可能跑在 PHP 7.4、8.1、8.3 上，全局只装一个 binary，一跑就可能：
- 在 PHP 7.4 项目里调用 PHP 8.1 的
parallel-lint，遇到箭头函数或属性类型声明直接报ParseError，但代码本身完全合法 - CI 环境从
composer install启动，没装全局命令，command not found直接中断流程 - 团队新人按文档装了全局版，结果和
composer.json里声明的 PHP 版本约束冲突，没人知道为啥 lint 结果不一致
怎么在 composer.json 里加一条可复用的 lint 命令
别写死路径，也别漏掉关键参数。直接往 "scripts" 里加：
"lint": "vendor/bin/parallel-lint --exclude vendor --exclude tests/Feature --exclude storage --php-version 8.1 ."
说明：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--php-version 8.1是关键：显式告诉工具“按 PHP 8.1 语法规则检查”，避免环境 PHP 版本干扰判断 -
--exclude至少排除vendor；tests/Feature和storage是 Laravel 项目常见无需检查目录，按自己项目结构删减 - 末尾的
.表示当前目录递归扫描，别漏掉它，否则默认只扫当前目录下文件（不进子目录） - 如果项目用了短标签（
），加--short-tags，否则会把合法短标签当语法错误
运行时报 ParseError 却确认语法没错？先看这三件事
典型现象：某文件明明能正常执行，parallel-lint 却卡在 ParseError: syntax error, unexpected token "="。这不是工具 bug，而是环境错配：
- 执行
which php和php -v，确认调用的是你预期的 PHP 版本（比如 Docker 容器里是 8.1，但宿主机$PATH优先用了系统自带的 7.4） - 检查该文件顶部是否有
// lint >= 8.1这类注释，如果有，但--php-version没匹配上，工具会跳过——但它不会告诉你“我跳过了”，只会静默漏检 - 运行
vendor/bin/parallel-lint --verbose ./path/to/file.php，看是否输出Skipped due to version constraint，这是最常被忽略的提示
CI 中怎么让失败真正阻断流程
parallel-lint 默认失败时返回非零退出码，但 CI 脚本里仍要显式处理：
- GitLab CI 或 GitHub Actions 中，直接写
composer lint || exit 1就够，不用额外包装 - 如果想聚合多个检查（如 PHPCS + parallel-lint），别用
&&串行——一个失败就停，看不到其他问题；改用分步执行 + 记录状态：composer lint<br>exit_code_lint=$?<br>composer phpcs<br>exit_code_php_cs=$?<br>if [ $exit_code_lint -ne 0 ] || [ $exit_code_php_cs -ne 0 ]; then exit 1; fi
- 注意
--no-progress参数：CI 日志里不需要进度条，加它能让日志更干净，也避免某些 CI 平台因 ANSI 控制字符解析异常而截断输出
最容易被忽略的是 --php-version 和文件内 // lint >= X.Y 注释的协同逻辑——两者不一致时，工具既不报错也不警告，只是跳过，导致本该发现的语法问题漏网。每次升级 PHP 版本或引入新语法特性，记得同步检查这两处。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
