唯一受支持的方式是通过composer create-project初始化完整项目结构，需确保php≥8.1、composer≥2.2及mbstring/curl扩展，配置国内镜像源后执行create-project命令，复制并修改.env启用development模式，最后用php spark serve启动服务。
要在本地快速跑起一个可调试的CodeIgniter 4项目，必须绕过手动解压、复制文件、改配置的老路——官方已明确弃用zip包安装，【唯一受支持的方式是通过composer create-project初始化完整项目结构】，否则大概率出现Class not found、路由失效或空白页。
确认环境与前置条件
先打开终端，依次执行三行命令验证基础环境：
php -v（确保输出 PHP ≥ 8.1，CI4.5起强制要求）→ composer -V（确保 Composer ≥ 2.2）→ php -m | findstr mbstring curl（Windows）或 grep -E 'mbstring|curl'
如果提示“command not found”，需先安装PHP和Composer；若PHP版本过低，直接升级到8.1或更高——用旧版强行安装CI4会导致spark命令报错、autoload失败。
配置国内镜像源（关键提速步骤）
方法一：项目级安全配置（推荐）
进入一个空目录，运行：composer init -n → 再执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/。这会把镜像写入当前目录下的composer.json的repositories字段，不污染全局配置，且在宝塔、GitHub Actions等环境中100%生效。
方法二：全局配置（仅限个人开发机）
运行：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。⚠️注意：【必须带composertype参数，且URL末尾要有/，否则静默回退到packagist.org】。验证是否成功：运行composer config -g repo.packagist，输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
创建CI4项目并启动服务
第一步：执行初始化命令
composer create-project codeigniter4/appstarter myapp --prefer-dist --no-interaction。其中myapp可替换为你想要的项目名，该命令会自动拉取appstarter模板、安装所有依赖（含framework、vfsstream等）、生成vendor/autoload.php、并运行初始迁移（如有）。
第二步：进入项目并激活环境配置
cd myapp → cp .env.example .env。这一步不能跳过，否则框架始终运行在production模式，错误不显示、日志不写、路由调试完全失能。
第三步：编辑.env文件
用VS Code或Notepad++打开.env，取消注释并修改三处：
① app.baseURL = "http://localhost:8080"（本地开发时必须与spark serve监听地址一致，否则CSS/JS全部404）
② CI_ENVIRONMENT = development（开启调试模式，否则任何语法错误都只返回空白页）
③ 若需连数据库，填写database.default.hostname等字段；但注意：CI4只读.env，不再加载app/Config/Database.php。
第四步：启动内置服务器
在项目根目录下运行：php spark serve。浏览器访问http://localhost:8080，看到CI4欢迎页即表示安装成功。
