Duster 接入 GitHub Actions：自动修复代码并优雅忽略 git blame 的完整方案

Duster 接入 GitHub Actions自动修复代码并优雅忽略 git blame 的完整方案【免费下载链接】dusterAutomatic configuration for Laravel apps to apply Tightens standard linting code standards.项目地址: https://gitcode.com/gh_mirrors/du/dusterDuster是一款面向 Laravel 项目的 PHP 代码风格工具它能一键应用 Tighten 官方编码规范。本文带你用一条命令把 Duster 接入 GitHub Actions实现提交后自动修复代码并通过.git-blame-ignore-revs优雅忽略机器人提交让git blame依然清晰可追溯。一、Duster 能做什么Duster 整合了 4 款主流 PHP 工具一条命令搞定代码检查与修复工具作用Pint应用 Laravel 官方代码风格含 Tighten 定制规则TLint检查其他工具覆盖不到的 Laravel 特有问题PHP CS Fixer补充自定义规则如类成员排序PHP_CodeSniffer检查无法自动修复的问题本地运行两个命令即可./vendor/bin/duster lint # 检查所有问题 ./vendor/bin/duster fix # 自动修复所有问题二、一键生成 GitHub Actions 工作流安装 Duster 后只需执行一条命令它就会交互式询问你的主分支名和工作流类型并自动生成配置文件到.github/workflows目录composer require tightenco/duster --dev ./vendor/bin/duster github-actions这条命令由 GitHubActionsCommand.php 实现提供3 种工作流供选择Lint only→ 只检查不改动代码Fix and commit→ 自动修复并提交✨Fix, commit, and update .git-blame-ignore-revs→ 修复 提交 忽略 blame推荐三、git blame 污染是怎么产生的自动修复类工作流会以机器人身份GitHub Action提交代码。随着时间推移git blame中会混入大量 Dusting 机器人提交真正的代码作者信息被冲淡。Duster 的fix-blame工作流给出了教科书式的解决方案核心逻辑在 duster-fix-blame.yml 中修复代码后用git-auto-commit-action提交消息为 Dusting如果检测到变更把该提交的commit hash追加写入.git-blame-ignore-revs文件再次提交这个忽略列表的更新Git 原生支持.git-blame-ignore-revs配合git blame --ignore-revs执行 blame 时会自动跳过这些机器人提交直接显示该行的真正作者。这就是优雅忽略的关键。四、注意自动提交不会触发新工作流⚠️ 有一个重要细节机器人提交的代码不会再次触发CI 工作流这是 GitHub 的机制而非 bug。如果你还有测试等工作流建议改用workflow_run触发器让它们在 Duster 完成后运行on: workflow_run: workflows: [Duster Fix] types: - completed这样既能享受自动修复又不影响后续 CI 流程。五、三种工作流怎么选场景推荐工作流代码库已很规范只想守住底线duster-lint.yml想让代码自动变规范duster-fix.yml团队重视git blame可追溯性duster-fix-blame.yml ✅六、常见问题Q不想全部修复只检查改动文件本地可加--dirty参数只处理 Git 未提交的变更文件./vendor/bin/duster fix --dirty。Q需要排除某些目录在项目根目录创建duster.json用include/exclude配置即可例如排除tests/fixtures。参考示例duster.json。Q本地没装 PHP容器环境Duster 也支持 Husky Git Hooks 方案通过--env指定 ddev、sail 等环境运行。总结借助 Duster接入 GitHub Actions 只需一条命令而fix-blame工作流利用.git-blame-ignore-revs机制让自动修复与提交历史可追溯性不再冲突。对于追求高质量代码又重视团队协作的 Laravel 项目来说这是一套开箱即用的完整方案 【免费下载链接】dusterAutomatic configuration for Laravel apps to apply Tightens standard linting code standards.项目地址: https://gitcode.com/gh_mirrors/du/duster创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考