CodeIgniter 4 安装必须用 composer create-project codeigniter4/appstarter myproject，而非 git clone 或手动下载，否则缺失 public/、writable/ 目录、.env 文件及 post-create-project-cmd 脚本，导致 spark 不可用、MigrationRunner 找不到、403/空白页等问题。
CodeIgniter 安装失败，90% 是因为没走对入口——不是直接 composer install 就完事，而是得用官方推荐的创建命令，否则缺核心引导文件、public 目录结构错乱、甚至 index.php 根本不在正确位置。
为什么 composer create-project 不能换成 git clone 或手动下载？
CI4 的项目骨架（appstarter）和框架内核（framework）是分离的，create-project 会自动拉取并组装好完整可运行结构；而手动下载或 clone 往往只拿到源码仓库，缺少 public/、writable/ 等关键目录，也缺失 .env 和预设路由。更隐蔽的问题是：某些 Composer 脚本（如 post-create-project-cmd）不会触发，导致 spark 命令不可用。
- ✅ 正确做法：
composer create-project codeigniter4/appstarter myproject - ❌ 错误做法：
git clone https://github.com/codeigniter4/framework.git后自己拼目录 - ⚠️ 注意：
myproject是新目录名，别在已有 CI 项目里重复执行，会覆盖vendor/
php spark migrate 报错 “Class 'MigrationRunner' not found” 怎么办？
这是典型的环境未就绪信号：不是迁移脚本本身出错，而是 CI4 的核心服务容器还没加载成功，通常因 public/index.php 没被 Web 服务器正确指向，或 .env 中 CI_ENVIRONMENT 被误设为 production 导致自动禁用开发组件。
- 检查
.env文件第一行是否为：CI_ENVIRONMENT = development - 确认 Web 服务器 DocumentRoot 指向的是
myproject/public/，不是项目根目录 - 运行前先试
php spark—— 如果连命令列表都打不开，说明 autoloader 或 bootstrap 失败，别急着跑 migrate
安装后访问首页显示 403 或空白页，但无错误日志
大概率是 writable/ 目录权限或 SELinux 限制所致。CI4 运行时需写入 writable/cache/、writable/logs/、writable/session/，Apache/Nginx 用户必须有写权限；而 Linux 发行版（尤其 CentOS/RHEL）默认启用 SELinux，会拦截 PHP 写入行为，此时 chmod 777 都无效。
- 先验证权限：
ls -ld writable/→ 应显示drwxr-xr-x或更宽松；再试sudo -u www-data touch writable/test.txt（Ubuntu）或sudo -u apache touch writable/test.txt（CentOS） - 若报 Permission denied，且
sestatus返回enabled，则临时关闭测试：sudo setenforce 0 - 生产环境不要关 SELinux，改用：
sudo semanage fcontext -a -t httpd_sys_rw_content_t "myproject/writable(/.*)?"，再restorecon -Rv myproject/writable/
最常被忽略的一点：CI4 不再允许通过项目根目录直接访问，index.php 必须经由 public/ 入口。哪怕你本地用 php -S localhost:8080，也得指定路由脚本：php -S localhost:8080 public/router.php，否则所有请求都会绕过框架初始化逻辑。
