答案是：因yii2模板post-install-cmd脚本依赖github api等外部资源，国内网络下极易超时或403卡死；正确做法是先执行composer install --no-scripts跳过脚本，再手动运行init.bat或./init补初始化，最后确保cookievalidationkey配置及web/为documentroot。
composer install 为什么在 Yii2 项目里经常失败
直接运行 composer install 却报错，不是依赖没装全，就是脚本卡死，本质是 Yii2 模板自带的 post-install-cmd 脚本（比如生成 cookie key、初始化权限）依赖 GitHub API 或外部资源，在国内网络环境下极大概率超时或 403。这不是你本地环境问题，而是模板设计本身对网络敏感。
- 基础版和高级版都默认启用这些脚本，
composer.json里能看到"post-install-cmd": ["yii\composer\Installer::postInstall"] - 错误现象常见为卡在
yiisoft/yii2-auth-client或bower-asset/类包下载阶段，终端长时间无响应，最后提示Failed to execute git clone或cURL error 7 - 别硬等——它不会自己恢复，Ctrl+C 中断后重试也大概率复现
正确执行 composer install 的三个关键动作
绕过脚本、指定稳定版本、补全缺失扩展，三步缺一不可。裸跑 composer install 在 Yii2 里基本等于主动踩坑。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先跳过脚本：
composer install --no-scripts—— 这是必须前置动作，避免卡死 - 再手动触发初始化（仅限高级版）：进入项目根目录后运行
init.bat（Windows）或./init（Linux/macOS），选0（开发环境） - 最后补关键配置：编辑
config/web.php，确保'cookieValidationKey' => 'your-secret-key-here'已填写；否则访问首页会抛InvalidConfigException
vendor/autoload.php 找不到？检查 Web 服务器 DocumentRoot 是否指向 web/
运行 composer install 成功后仍报 Class 'Yii' not found 或空白页，90% 是 Web 服务器没配对路径，跟 Composer 无关。
- Apache/Nginx 的
DocumentRoot必须设为项目根目录下的web/子目录（例如/var/www/html/myproject/web），不是项目根目录 - 确认
web/index.php开头有这行：require __DIR__ . '/../vendor/autoload.php';—— 缺了或路径写错就会加载失败 - 用内置服务器测试最省事：
php yii serve --port=8080，但得确保当前目录是项目根目录，且yii文件有执行权限（Linux/macOS 执行chmod +x yii）
升级时慎用 composer update，锁死小版本更安全
composer update 在 Yii2 项目里风险极高，尤其当你用的是已 EOL 的 2.0.x 版本（如 2.0.48）。松散版本约束（如 "~2.0.0"）可能拉入不兼容变更，导致 Deprecated 警告甚至 fatal error。
- 生产环境永远用
composer install（读composer.lock），禁用update - 开发中若真要升级，显式指定小版本：
composer require yiisoft/yii2:2.0.48，而非composer update yiisoft/yii2 - 检查
composer.json里所有 Yii 相关包（如yii2-debug、yii2-gii）是否都加了精确版本约束，避免意外升级
mbstring、openssl、pdo_mysql 缺一不可，web/ 目录下 assets/ 和 runtime/ 必须可写，否则 Gii、日志、缓存全挂。
