Laravel Pint 是 Laravel 官方推荐的轻量级 PHP 代码格式化工具，基于 PHP-CS-Fixer 构建但更简洁，开箱即用，支持 ./vendor/bin/pint 格式化、--test 预览、pint.json 自定义规则，并可集成到 VSCode 保存钩子、Git 提交前校验（lint-staged）及 CI/CD 流程中，确保代码风格统一。
在将Laravel项目交付上线前，必须确保代码风格统一、语法无误、逻辑健壮，否则轻则引发CI流水线失败，重则导致生产环境运行异常。仅靠人工审查无法覆盖所有PHP、JS、Vue文件，需将代码质量检查嵌入开发流程起点。
安装并启用PHP代码格式化工具
使用Laravel官方推荐的Pint替代传统PHP CS Fixer，它更轻量、与Laravel生态深度对齐。
在项目根目录执行：composer require --dev laravel/pint
验证安装是否成功：运行 vendor/bin/pint --version，输出应为 v1.13.0 或更高版本。若提示命令未找到，请确认 composer install 已完成且 vendor/bin 在系统PATH中。
这一步操作起来很简单，直接把文件拖进去就行。但【必须在 .gitignore 中排除 vendor/bin/pint 的软链接】，否则不同开发者机器上的二进制路径可能冲突，导致Git提交失败。
配置VSCode实现保存即格式化
让编辑器自动调用Pint处理PHP文件，避免手动执行命令的遗漏。
打开VSCode设置（Ctrl+,），搜索“format on save”，勾选“Editor: Format On Save”。
在 settings.json 中添加以下配置项：
"[php]": { "editor.defaultFormatter": "bmewburn.vscode-intelephense-client", "editor.formatOnSave": true }, "php.suggest.basic": false, "intelephense.format.enable": false, "editor.codeActionsOnSave": { "source.fixAll.php": true }
关键点在于禁用Intelephense内置格式化，否则它会与Pint争抢控制权，造成保存时格式反复抖动。重启VSCode后，任意PHP文件保存时将自动触发Pint修复。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
集成lint-staged实现提交前校验
防止不合规代码进入Git暂存区，强制所有团队成员遵守同一套规则。
第一步：安装依赖npm install --save-dev lint-staged husky
第二步：初始化husky钩子npx husky install && npx husky add .husky/pre-commit "npx lint-staged"
第三步：创建 .lintstagedrc.js 配置文件，内容如下：
module.exports = { "*.php": ["vendor/bin/pint --test"], "*.{js,ts,vue}": ["eslint --fix", "prettier --write"] };
注意：PHP命令使用 --test 参数而非 --write，因为 lint-staged 期望命令返回非零退出码来中断提交——当Pint发现可修复问题时，--test 会报错并阻止commit，而 --write 总是成功退出，失去拦截意义。
配置PHPStan进行静态类型分析
方法一：快速启用基础检查
执行 composer require --dev phpstan/phpstan，然后运行 vendor/bin/phpstan analyse app/ --level=5。该级别能捕获空变量访问、未定义属性等高频错误。
方法二：深度集成到VSCode
安装扩展“PHPStan”或“PHP Intelephense”，并在项目根目录创建 phpstan.neon：
parameters:<br> level: 6<br> paths:<br> - app<br> - tests<br> includes:<br> - vendor/laravel/framework/src/Illuminate/Support/PhpStan/extension.neon
VSCode的“问题”面板将实时显示PHPStan警告，无需切换终端。此配置要求Laravel版本 ≥ 10.0，低版本缺少 extension.neon 文件会导致解析失败。
运行全量代码质量扫描
在CI脚本或本地发布前执行最终校验：
vendor/bin/pint --dirty && vendor/bin/phpstan analyse --no-progress --memory-limit=512M && npm run lint
这条命令串联三项检查：Pint验证暂存区PHP文件、PHPStan扫描app与tests目录、npm lint执行JS/TS/Vue规则。任一环节失败，整个命令退出码非零，CI将终止构建。
