应使用 composer create-project laravel/laravel my-app 安装 Laravel，它自动拉取骨架、安装依赖、生成 .env 并执行 key:generate；指定版本需用 "10.*" 等语义化约束，不可省略引号或写 v 前缀。
直接用 composer create-project 就能拉出一个开箱即用的完整项目，但前提是包名对、版本稳、目录空——错一个，就卡在“Could not find package”或“Destination directory is not empty”上。
为什么 create-project 不是 require 的替代品
它不往现有项目里加东西，而是从头建一个带 app/、routes/、public/、artisan（或 bin/console）的完整骨架。比如：
-
composer require laravel/framework→ 只装内核，没artisan，没.env，跑不起来 -
composer create-project laravel/laravel myapp→ 自动下载完整结构 + 执行post-create-project-cmd生成密钥 + 安装全部依赖
误用 require 替代，结果得到一个只有 vendor/ 的空壳，连 php artisan serve 都报错“Command 'serve' is not defined”。
laravel/laravel 和 laravel/framework 到底该用哪个
必须用 laravel/laravel（官方项目模板），不能用 laravel/framework（纯框架内核）。判断依据只有一个：Packagist 页面的 "type": "project" 字段。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 支持
create-project的包，composer.json中必须有"type": "project" -
laravel/framework的 type 是library，create-project会直接报Could not find package - 其他框架同理：用
symfony/skeleton，不用symfony/framework-bundle；用yiisoft/yii2-app-basic，不用yiisoft/yii2
执行时卡住或报错，先盯这三处
错误往往藏在输出中间几行，而不是开头。重点关注：
- 目标目录已存在且非空 → 报
Destination directory "myapp" is not empty.，加-n（--no-interaction）不会跳过，得手动rm -rf myapp - 版本号没加引号 →
composer create-project laravel/laravel myapp 10.*会被 shell 展开成通配符，改用"10.*" - PHP 版本不匹配 → 比如在 PHP 8.2 下跑
yiisoft/yii2-app-basic（只支持到 PHP 7.4），会卡在mbstring检测或ReflectionParameter::getClass()弃用警告上
调试时加 -vvv，能看到具体卡在哪一步：是 Git clone 失败？还是某个子包下载超时？
私有模板或自定义包怎么用
只要 Composer 能访问到这个包（已配置 repositories 或包本身公开），且其 composer.json 含 "type": "project"，就能用。
- 私有 Git 仓库必须写完整 URL：
git@github.com:myorg/my-template.git，不能简写为myorg/my-template - 本地开发测试时，
create-project不支持path协议，得先composer config repositories.mylocal path ./my-template，再用包名调用 - 加
--no-scripts可跳过初始化脚本（如 Laravel 的key:generate），适合 CI 场景或想手动控制流程
真正难的从来不是命令敲对了没，而是你信不信这个模板的 post-create-project-cmd 脚本能正确处理你的环境权限、PHP 路径和扩展加载顺序——这些细节不会报错，但会让 .env 写错、密钥生成失败、甚至 autoload.php 加载不到。
