常见原因是 Composer 源配置了国内镜像但未同步最新包，或 PHP 版本不兼容；grumphp 依赖较新版本的 Symfony 组件，需 PHP ≥7.4 且建议切换官方源或更新镜像。
grumphp 安装失败：composer require 报错 Could not find package phpro/grumphp
常见原因是 Composer 源配置了国内镜像但未同步最新包，或 PHP 版本不兼容。grumphp 依赖较新版本的 Symfony 组件，PHP
- 先确认 PHP 版本：
php -v，必须 ≥ 7.4（推荐 8.0+） - 临时切回官方源再安装：
composer config -g repo.packagist composer https://packagist.org - 运行：
composer require --dev phpro/grumphp（--dev是必须的，它不是运行时依赖） - 装完立刻执行：
vendor/bin/grumphp git:init，否则钩子不会生效
git commit 不触发 grumphp：hook 没注册或被跳过
grumphp 默认只在 git commit 时检查，但很多人误以为 push 或其他操作也会触发。更常见的是 hook 被绕过（比如用了 -n、--no-verify），或项目根目录下没生成 .git/hooks/pre-commit
- 检查 hook 文件是否存在：
ls -l .git/hooks/pre-commit，应是可执行脚本，内容含grumphp - 如果不存在，手动重跑初始化：
vendor/bin/grumphp git:init - 避免跳过检查：
git commit -m "xxx"（不要加-n或--no-verify） - Windows 用户注意：Git Bash 下可能因路径权限问题导致 hook 不执行，建议用 WSL 或重新 init
grumphp.yml 配置无效：任务不运行或报错 Task "phpcs" is not registered
这是典型插件未安装或配置名拼写错误。grumphp 本身不自带检查工具，每个 task（如 phpcs、phpstan）都需要单独 require 并在配置中显式启用。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先装对应工具：
composer require --dev squizlabs/php_codesniffer - 确保
grumphp.yml在项目根目录，且顶层键是grumphp:（注意冒号） - task 名必须小写、全匹配，比如
phpcs不是PHP_CodeSniffer；检查是否漏了tasks:嵌套层级 - 配置示例片段：
grumphp: tasks: phpcs: standard: PSR12 triggered_by: ['php']
CI 环境下 grumphp 执行超时或失败
CI（如 GitHub Actions、GitLab CI）通常无交互、无 TTY，而某些 grumphp task（如 phpunit 带 --colors）会因输出控制异常崩溃；另外默认 timeout 是 60 秒，大型项目静态分析容易超时。
立即学习“PHP免费学习笔记（深入）”；
- 在
grumphp.yml中显式关掉颜色和进度条：phpunit: {colors: false, verbose: false} - 调高全局超时：
process_timeout: 300（单位秒） - CI 中建议跳过 pre-commit hook，改用独立命令：
vendor/bin/grumphp run，并放在 test 步骤里 - 注意：CI 默认不装 dev-dependencies？确认
composer install没加--no-dev
-v 参数看真实 stderr；还有就是 .git/hooks 下的脚本是生成出来的，别手改，每次 git:init 都会覆盖。 
