Composer 是 CodeIgniter 4 的核心运行基础，项目必须通过 composer create-project 初始化，依赖自动加载严格遵循 composer.json 配置，第三方包直接 require 即可使用，升级需区分框架与依赖，部署应使用 --no-dev 和 --optimize-autoloader。
在 CodeIgniter 4 中，Composer 不只是安装依赖的工具，它本身就是框架运行的基础——CI4 本身即通过 Composer 管理核心组件、自动加载和扩展包。正确使用 Composer，关键在于理解它与 CI4 生命周期的深度集成，而非当作外部插件来“对接”。
初始化项目时必须用 Composer 创建
CI4 官方不再提供完整 ZIP 包下载，所有正规项目都应通过 Composer 初始化：
-
新建项目：运行
composer create-project codeigniter4/appstarter myproject，这会拉取官方应用骨架，并自动安装 CI4 核心（codeigniter4/framework）及依赖（如psr/log、symfony/polyfill等） -
不要手动复制 vendor 或 framework 目录：CI4 的 autoloader 严格依赖
composer.json中的 autoload 配置（如"psr-4": { "App\\": "app/", "CodeIgniter\\": "vendor/codeigniter4/framework/" }），手动生成会破坏命名空间映射 - 生成后务必运行
php spark serve验证，确保自动加载和路由正常
添加第三方包要走标准 require 流程
CI4 对 Composer 包完全兼容，但需注意路径与配置协同：
- 例如安装
league/csv：执行composer require league/csv，Composer 自动写入composer.json并更新vendor/autoload.php - 在控制器或服务中直接使用：
$csv = \League\Csv\Reader::createFromPath('/path/to/file.csv');，无需额外引入——PSR-4 自动识别 - 若包含自定义命令（如
spark子命令），需在app/Config/Boot/development.php或production.php中确认require_once SYSTEMPATH . 'Commands/...已启用（多数现代包已通过codeigniter4/legacy-compat或原生支持）
更新与维护要区分框架与应用逻辑
CI4 版本升级不能简单 composer update 全局更新，否则可能破坏兼容性：
- 只升级框架：运行
composer update codeigniter4/framework，CI4 会校验app/Config/App.php中的$version并提示变更日志链接 - 升级其他依赖（如
monolog/monolog）可单独操作，但建议先查看 CI4composer.json的"replace"和"conflict"字段，避免版本冲突 - 每次
composer update后，务必运行php spark migrate:status和php spark test（如有测试套件），验证数据库层与业务逻辑稳定性
部署时精简 vendor，跳过开发依赖
生产环境应排除调试类库以提升性能与安全性：
- 部署前执行：
composer install --no-dev --optimize-autoloader --no-interaction -
--optimize-autoloader生成 classmap，加速 PSR-4 查找；--no-dev跳过phpunit、fakerphp/faker等仅开发期需要的包 - CI4 的
app/Config/Logger.php默认根据 ENVIRONMENT 切换日志级别，配合 Composer 的环境隔离，天然适配生产部署流程
基本上就这些。Composer 在 CI4 里不是可选配件，而是呼吸系统——从项目诞生、扩展到上线，每一步都依赖它的规则运转。按规范走，反而最省事。
