在不影响生产环境的前提下为 Composer 项目引入新开发工具，关键是严格分离开发与运行时依赖：使用 composer require --dev 安装工具、部署时加 --no-dev 参数、禁用自动发现、条件加载服务提供者、隔离配置与脚本，并通过 composer install --no-dev 验证生产构建干净性。
在不影响生产环境的前提下为 Composer 项目引入新开发工具，核心是严格分离开发依赖与运行时依赖，并确保部署流程不加载或执行 dev-only 的代码和配置。
只在 dev 环境安装工具
使用 composer require --dev 安装所有开发专用工具（如 PHPUnit、PHPStan、PHP-CS-Fixer、Laravel Pint、infection 等）。这样它们只会写入 require-dev 区块，不会进入生产依赖树。
- 执行命令示例：
composer require --dev phpunit/phpunit ^10 - 检查
composer.json，确认新增项出现在"require-dev"下，而非"require" - CI/CD 或上线部署时务必加
--no-dev参数（如composer install --no-dev --optimize-autoloader）
避免开发工具污染生产自动加载和配置
某些工具（尤其是带 ServiceProvider 或配置文件的 Laravel 扩展）可能在启动时被自动加载，即使未调用也会触发副作用。
- 禁用开发包的自动发现：在
composer.json的"extra"中关闭自动发现，例如：
"laravel": { "dont-discover": ["barryvdh/laravel-debugbar"] } - 条件加载服务提供者：在 Laravel 中，仅在
APP_DEBUG=true或app()->environment('local', 'testing')时注册调试类 - 将工具配置（如 phpstan.neon、phpcs.xml）放在项目根目录，不通过框架配置机制加载
隔离开发脚本与入口逻辑
不要把开发工具调用逻辑硬编码进生产入口文件（如 public/index.php 或 bootstrap/app.php）。
- 用独立的 CLI 脚本或 Composer scripts 启动工具，例如在
composer.json中添加：
"scripts": { "test": "phpunit", "cs-fix": "php-cs-fixer fix" } - 所有开发相关命令统一通过
composer run test或./vendor/bin/phpunit显式触发 - 禁止在
index.php中判断环境后 require 开发类 —— 这会导致生产环境仍需加载其类文件
验证生产构建是否真正干净
上线前快速验证：模拟生产环境安装并检查结果。
- 本地执行：
rm -rf vendor && composer install --no-dev --optimize-autoloader && ls -la vendor/，确认无 dev-only 包目录 - 检查 autoloader：
grep -r "phpunit\|phpstan\|debugbar" vendor/composer/autoload_*.php，应无匹配 - 用
composer show --dev查看当前已安装的 dev 包列表，再对比--no-dev后是否清空
基本上就这些。关键不是“能不能装”，而是“装完会不会悄悄跑”。控制好安装范围、加载时机和部署参数，新工具就能安心待在开发侧，不越界一步。
