composer create-project才是真·模板初始化，它下载完整项目骨架（含public/、.env.example、artisan等），执行composer install和post-create-project-cmd脚本（如自动生成APP_KEY）；而laravel new被官方弃用，composer init仅生成空配置。
直接用 composer create-project，别用 laravel new 或 composer init ——前者是官方弃用的黑盒封装，后者只生成空配置，都不算“基于模板创建项目”。
为什么 create-project 才是真·模板初始化
它不是安装依赖，而是下载整个项目骨架（含 public/、.env.example、artisan 等），再执行 composer install 和 post-create-project-cmd 脚本（比如自动生成 APP_KEY）。composer init 只给你一个空 composer.json，连目录结构都要手建。
- 真正生效的是包的
"type": "project"字段——查一个包是否可用：composer show laravel/laravel | grep type，输出含project才行 - 常见能用的模板：
laravel/laravel（不是laravel/framework）、symfony/skeleton、roots/bedrock - 拉到的不是源码片段，而是完整可运行的项目快照，vendor 里装的是该模板声明的全部依赖，不是你当前环境的全局依赖
create-project 命令必须带全三个参数
漏掉任一参数都可能出错或行为异常：
-
<package>：必须是完整包名，如laravel/laravel；也支持 Git URL（git@github.com:myorg/starter.git）或本地路径（../templates/my-starter） -
<directory>：目标文件夹不能已存在（哪怕为空），否则报错退出；想覆盖？先rm -rf myapp -
<version>：必须加引号，如"11.*"或"dev-main"；不加引号时 shell 会把*当前目录通配符展开，导致版本解析失败
不加这些选项，CI/CD 和 Docker 里大概率卡住
默认交互式行为在无终端环境（如 GitHub Actions、Docker build）中会永久挂起：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--no-interaction（简写-n）：跳过 Git 凭据、是否初始化 Git 仓库等所有提问 -
--prefer-dist：强制走压缩包安装，比--prefer-source（Git clone）快且稳定，国内网络尤其关键 -
--remove-vcs：删掉模板自带的.git，避免新项目继承错误提交历史 -
--no-scripts：调试模板时临时禁用post-create-project-cmd（比如.env生成逻辑有 bug），确认结构后再去掉
典型稳态命令：composer create-project laravel/laravel myapp "11.*" --no-interaction --prefer-dist --remove-vcs
装完立刻验证三件事，别等 php artisan 报错才回头
静默失败很常见，vendor 目录看似存在，但 autoload 可能没生成成功：
- 检查
vendor/autoload.php是否存在且可读——WSL 或 Docker volume 挂载时，symlink 可能被跳过，导致文件缺失 - 运行
php artisan tinker：能进入交互式控制台，说明 autoloader 和基础命令链正常 - 确认
.env有内容且APP_KEY已生成——加了--no-scripts就不会自动执行key:generate，得手动补
最易忽略的是权限和镜像源问题：如果 vendor/ 为空或不全，先 composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ 换国内源，再重试；Windows 下避免用 Git Bash，换 PowerShell 或 CMD。
