必须用 composer create-project 安装 yii2，它自动拉取含 web/index.php、config/、environments/、vendor/bin/yii 的完整应用骨架；仅执行 composer require yiisoft/yii2 只装内核，缺失入口文件和配置结构，必然导致白屏、404 或 class 'yii' not found。
想用Composer快速装好可直接运行的Yii2最新版项目，避免白屏、404或Class not found报错，必须跳过仅安装内核的错误路径，直取完整应用模板。
确认PHP环境达标
执行 php -v 查看版本：Yii 2.0.x 最后稳定版（2.0.48）要求 PHP 7.4–8.1；若显示 8.2.0 或更高，create-project 可能静默失败或后续报 Deprecated: strlen(): Passing null to parameter #1。
运行 php -m | grep -E "mbstring|openssl|pdo_mysql"，缺任一扩展都会让命令中断并提示 【Your requirements could not be resolved】。
Linux/macOS 下记得给 vendor/bin/yii 加执行权限：chmod +x vendor/bin/yii；Windows 直接用 yii.bat。
换国内镜像 + 跳过卡死脚本
国内网络环境下，不换源大概率卡在 yii2-auth-client 或 GitHub API 请求上，超时后 vendor/ 目录空空如也但命令无报错。
先全局换阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
加 --no-scripts 参数跳过 post-install-cmd（比如自动生成 cookie key、初始化权限等网络敏感操作）：composer create-project --no-scripts --prefer-dist yiisoft/yii2-app-basic myproject
装完进目录，再手动跑：php init → 选 Development / Production → 它会补全 environments/ 并生成 cookieValidationKey。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
一步到位拉取完整模板
方法一：基础版（推荐新手）composer create-project --prefer-dist yiisoft/yii2-app-basic basic
方法二：高级版（前后端分离结构）composer create-project --prefer-dist yiisoft/yii2-app-advanced advanced
⚠️ 注意：composer require yiisoft/yii2 只装内核，缺失 web/index.php、config/、environments/、vendor/bin/yii 等全部必需文件，【必然白屏或 Class 'Yii' not found】。
模板包在 autoload.files 里预置了 Application 初始化逻辑，内核包根本没这个能力；漏掉模板，php yii migrate 或 php yii serve 直接报错：命令未注册或找不到 console/config/main.php。
处理 GitHub Token 输入环节
第一步：登录 GitHub → 右上角头像 → Settings → 左侧 Developer settings → Personal access tokens → Generate new token。
第二步：填描述（如 “yii-install”），下方权限全勾选，提交生成。
第三步：回到终端，粘贴 token（输入时不可见，粘贴一次即可，别反复按回车）。
这一步操作起来很简单，直接把生成的 token 复制进去就行。如果输错三次，命令会退出，需重试整个 create-project 流程。
