composer create-project适合原型验证，因其能一键克隆预打包模板并执行初始化钩子，省去手动建目录、写配置、装依赖等步骤，配合--remove-vcs --no-interaction可确保干净、自动化启动。
直接用 composer create-project 搭建原型脚手架是可行的，但必须清楚它不生成代码、不渲染变量、不交互提问——它只是克隆一个已打包好的项目模板，并执行其中预设的初始化逻辑。能不能快速验证想法，取决于你选的模板是否轻量、是否带钩子、是否适配当前 PHP 版本。
为什么 composer create-project 适合原型验证
它省去了手动建目录、复制文件、写 composer.json、装依赖、初始化环境这几步，尤其适合需要“5 分钟跑起来看效果”的场景。比如：
- Laravel 的
laravel/laravel模板自带路由、中间件、.env.example 和 Artisan 命令，php artisan serve一跑就出欢迎页 - Symfony 的
symfony/skeleton极简到只有 Kernel 和配置，没多余 bundle，适合验证容器、事件或命令行逻辑 - ThinkPHP 的
topthink/think默认带php think run，连 Web 服务器都不用额外装
这些模板都把“可运行”作为第一目标，而不是“可扩展”。原型阶段要的就是快和干净，不是工程完备性。
--remove-vcs 和 --no-interaction 必须加
不加 --remove-vcs，新项目里会带着模板仓库的 .git 目录，第一次 git commit 就可能把上游提交历史一起推上去；不加 --no-interaction，某些模板在 CI 或脚本中会卡在交互式提示（比如问你是否重命名 .env），导致自动化失败。
立即学习“PHP免费学习笔记（深入）”；
- 正确命令示例：
composer create-project laravel/laravel proto-app --remove-vcs --no-interaction - 如果模板用了
post-create-project-cmd钩子（如生成密钥、复制 .env），这个钩子默认仍会执行，--no-interaction不会跳过它 - 想跳过钩子？只能临时删掉模板包里的
scripts.post-create-project-cmd字段，但这需要改模板源，不推荐
常见失败点：不是包名错，而是环境不匹配
报 Could not find package 时，90% 不是拼写问题，而是：
- Composer 镜像源滞后：比如 Packagist 官方刚发布 Laravel 11，国内镜像还没同步，执行
composer config -g repo.packagist composer https://packagist.org切回官方源再试 - PHP 版本不兼容：模板
composer.json中声明"php": "^8.2"，而你本地是 8.1，就会被跳过；用php -v和composer show topthink/think对比版本约束 - 模板未设
"type": "project"：虽然非强制，但很多工具链（如 IDE 识别、部署脚本）依赖这个字段判断是否为脚手架包 - 私有模板没配
repositories：必须在全局或项目级composer.json里显式声明 VCS 源，否则create-project根本看不到它
原型验证后，别直接往里堆业务代码
脚手架拉下来的是一次性快照，后续升级困难。比如你基于 laravel/laravel:^10.0 启动原型，之后想升到 11.x，不能靠 composer update 平滑过渡——因为 laravel/laravel 是项目包，不是库包，它的更新策略和 laravel/framework 不同。真正要进生产，得把核心逻辑抽成独立包，或从头按正式项目结构重建。
