必须配置阿里云Composer中文镜像三要素（repo.packagist键名、composer类型、URL末尾/）并验证生效，再执行composer create-project codeigniter4/appstarter myproject "4.7.4" --prefer-dist --no-interaction，最后用php spark serve启动并访问localhost:8080确认版本v4.7.4。
在国内网络环境下安装CodeIgniter框架v4.7.4，直接运行composer create-project大概率卡在依赖下载或超时失败，必须先配置可用的中文镜像源并验证生效，否则整个安装流程无法推进。
确认Composer已安装并检查版本
打开终端，执行composer --version。输出应包含version 2.5.0+或更高——CI4.7.4要求Composer 2.5+，低于此版本会报Unsupported composer version错误。
若未安装或版本过低，请先卸载旧版：sudo apt remove composer（Ubuntu/Debian）或brew uninstall composer（macOS），再按官方方式重装。
配置阿里云Composer中文镜像（三要素缺一不可）
执行以下命令，注意顺序和空格：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
这一步必须同时满足三个条件：键名是repo.packagist（不是repos.packagist）、显式声明composer类型、URL末尾带/。漏掉任意一个，Composer都会静默回退到packagist.org，你完全看不到提示。
验证是否生效：运行composer config -g repo.packagist。正确输出应为：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回null或空对象，说明配置失败，需重新执行带composer类型的完整命令。
创建CI4.7.4项目（推荐项目级镜像）
新建空目录，进入后执行：
composer init -n → composer config repo.packagist composer https://mirrors.aliyun.com/composer/
项目级配置比全局更可靠，尤其在宝塔、Docker或CI/CD环境中，避免因用户权限或配置文件路径不同导致镜像失效。
接着运行安装命令：
composer create-project codeigniter4/appstarter myproject "4.7.4" --prefer-dist --no-interaction
指定版本号"4.7.4"很重要——不加引号或写成4.7.4（无引号）会导致Composer解析失败；加双引号才能被正确识别为版本约束。该命令会拉取appstarter模板及其全部子依赖（如codeigniter4/framework），全部走阿里云镜像。
安装后必要校验
进入myproject目录，运行php spark serve。
浏览器访问http://localhost:8080，页面显示“Welcome to CodeIgniter4”且右上角版本号为v4.7.4，说明安装成功。
若首页空白或报Class 'CodeIgniter\CodeIgniter' not found，说明vendor/autoload.php未加载，检查public/index.php第13行是否仍为require FCPATH . '../vendor/autoload.php';——有人误删../导致路径错误。
