必须用 composer global require laravel/pint 全局安装,因 php artisan pint 依赖系统 PATH 中的 pint 命令,而非 vendor/bin/pint;项目级安装会导致命令不可用、CI/CD 失败及 PATH 配置遗漏。

直接装,别走 Packagist 官网手动下——Pint 是 Laravel 官方工具,必须用 Composer 的 global 或项目本地方式装,否则后续和 php artisan 集成会断链。
为什么不能用 composer require laravel/pint --dev 直接装到项目里?
Pint 不是普通依赖,它不提供运行时功能,也不被项目代码调用。它的二进制文件 pint 是独立 CLI 工具,需要能从命令行任意路径执行。如果只用 require --dev,它只会放进 vendor/bin/pint,而 Laravel 的 php artisan pint 命令依赖的是全局可执行的 pint,不是 vendor 里的副本。
-
php artisan pint底层会尝试调用系统 PATH 中的pint命令,不是 vendor 路径下的同名文件 - 某些 Laravel 版本(如 10.42+)甚至会检测
pint是否在 PATH 中,不在就报错:Command "pint" is not defined. - 项目级安装后,CI/CD 或新开发者拉代码容易漏掉
vendor/bin/pint权限或 PATH 设置,导致格式化失败
推荐安装方式:优先用 composer global require laravel/pint
这是 Laravel 文档明确支持的方式,也是 php artisan pint 能正常工作的前提。前提是你的 Composer global bin 目录已加入系统 PATH。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先确认 global bin 路径:
composer global config bin-dir --absolute,常见输出类似/home/you/.composer/vendor/bin或C:\Users\You\AppData\Roaming\Composer\vendor\bin - 把它加进系统 PATH(Linux/macOS 加入
~/.bashrc或~/.zshrc;Windows 在系统环境变量里改) - 再执行:
composer global require laravel/pint - 验证:
pint --version能输出版本,且which pint(macOS/Linux)或where pint(Windows)指向 global bin 目录
遇到 command not found: pint 怎么快速排查?
不是 Pint 没装好,大概率是 PATH 没生效,或者 shell 缓存没刷新。
- 新开一个终端窗口再试——很多用户改完 PATH 后还在旧 shell 里测试
- 检查是否用了不同 shell:
echo $SHELL和ps -p $$看当前 shell 类型,确保改的是对应配置文件(.zshrc还是.bash_profile) - Windows 用户注意:Composer 默认用 PowerShell 安装 global 包,但 CMD 可能读不到同一 PATH,建议统一用 PowerShell 执行
pint - 如果公司用 Docker 或 Laravel Sail,别在宿主机装 global —— 改用
sail composer global require laravel/pint,并确保容器内 PATH 包含 global bin
真正卡住人的地方,从来不是“怎么装”,而是装完之后命令找不到——PATH 没生效、shell 没重载、宿主机和容器环境混用,这三个点占了 90% 的问题。装完务必用 which pint 或 where pint 看一眼实际路径。

















