codeigniter 4 正确安装调试需三步：用 composer 创建完整项目、复制并配置 .env 启用开发模式、执行 php spark serve 启动服务；环境须满足 php ≥ 8.1、composer ≥ 2.2 且启用 mbstring 和 curl 扩展。
CodeIgniter 4 的安装与调试，核心就三件事：用 Composer 正确拉起项目、改对 .env 文件启用开发模式、用 php spark serve 启动服务。跳过任一环节，轻则报错不显示，重则页面空白或 500 错误。
确认环境是否达标
CI4.5 起强制要求 PHP ≥ 8.1、Composer ≥ 2.2，并且必须启用 mbstring 和 curl 扩展。别靠猜——打开终端，逐条执行：
-
php -v→ 看输出是否为 8.1 或更高版本 -
composer -V→ 确认版本号 ≥ 2.2 - Windows 执行：
php -m | findstr mbstring curl；Linux/macOS 执行：php -m | grep -E 'mbstring|curl'→ 必须同时看到两行输出
如果任一检查失败，先升级 PHP 或 Composer，或在 php.ini 中启用对应扩展。旧版 PHP 强行装 CI4，会导致 spark 命令直接崩溃，autoload 失效。
用 Composer 创建完整项目（唯一官方支持方式）
别下载 ZIP 包、别手动复制 system/application、也别只 composer require codeigniter4/framework——那只是装个类库，不是可运行项目。
- 进入一个空目录，执行：
composer create-project codeigniter4/appstarter myapp --prefer-dist --no-interaction（myapp可换成你想要的项目名） - 该命令会自动：拉取 appstarter 模板、安装 framework + 所有依赖（如 vfsstream）、生成
vendor/autoload.php、初始化writable/目录权限、写入.env.example - 完成后，
cd myapp进入项目根目录
激活开发环境并配置基础参数
CI4 默认运行在 production 模式，错误不显示、日志不写、路由调试完全关闭——这是新手最常卡住的地方。
- 执行：
cp .env.example .env（这一步不能跳） - 用编辑器打开
.env，取消注释并修改以下三行（注意格式和等号前后无空格）：
CI_ENVIRONMENT = development
database.default.hostname = "localhost"
特别注意：app.baseURL 必须和后续 spark serve 实际监听地址**完全一致**，否则静态资源 404、CSRF 校验失败、路由匹配异常。数据库配置即使暂不用，也别留空，否则 Logger 等系统服务初始化会抛出未捕获异常。
启动服务并验证结果
在项目根目录下执行：php spark serve
- 该命令会读取
.env中的app.baseURL并校验，不匹配直接报错退出，不会静默降级 - 成功后终端会提示
CodeIgniter v4.x.x Development Server Started，并显示监听地址 - 浏览器访问
http://localhost:8080，看到 CI4 欢迎页即表示一切正常
所有请求都必须经由 public/index.php 入口，绝不能把整个项目根目录设为 Web 根目录——否则 writable/ 目录暴露、路由失效、存在严重安全风险。
