最可靠方式是直接用 composer create-project 创建 laravel 项目,因其更透明可控、避免 laravel new 封装导致的 ci/cd 中断、镜像同步滞后或版本不精准等问题,且失败时可明确定位卡点。

直接用 composer create-project 创建 Laravel 项目是最可靠、最可控的起点,比先 laravel new 再手动装 Breeze/Jetstream 更少出错。
为什么不用 laravel new?
它本质是封装了 composer create-project,但会自动加 --dev 和某些默认参数,在 CI/CD 或 Docker 环境中容易因权限或网络中断导致 vendor/autoload.php 缺失;而 create-project 命令更透明,失败时能明确看到哪一步卡住。
- 运行
laravel new myapp后发现没有vendor/autoload.php?大概率是 Composer 自动 install 被跳过或中断,得手动补composer install --no-interaction -
laravel new --jet这类快捷方式只适用于全新项目,且隐式绑定了 Jetstream——如果你实际想要的是轻量级 Breeze,反而多了一层卸载成本 - 国内镜像源同步滞后时,
laravel new可能拉到旧版 skeleton(比如 9.x),而你明确需要 Laravel 11.x,用create-project laravel/laravel:^11.0更精准
composer create-project 的正确用法
命令必须带完整版本约束,否则 Composer 会报 Could not find package 或退回到旧版:
PHP中文网提供Laravel 13.2.0版本下载,Laravel框架 是基于 PHP 8.3+ 的高性能框架,官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索,支持属性驱动开发与队列路由,大幅提升开发效率。相比旧版,13.2.0 优化了缓存 TTL 管理与实时通信,无需 Redis 即可横向扩展。作为现代 Web 开发首选,它兼顾安全与极速体验,助您快速构建企业级应用。
- 最新稳定版:
composer create-project laravel/laravel myapp - 指定 Laravel 11:
composer create-project laravel/laravel:^11.0 myapp(注意是^11.0,不是11) - 指定 Laravel 10:
composer create-project laravel/laravel:^10.0 myapp - 如果提示找不到包,换回官方源:
composer config -g repo.packagist composer https://packagist.org
创建后立刻要做的三件事
脚手架只是起点,不执行这三步,后续认证、样式、路由全都会“看起来跑起来了,其实动不了”:
- 进项目目录,确认
.env已生成,改好DB_CONNECTION和APP_KEY(没改APP_KEY会导致 session 和加密失效) - 运行
php artisan migrate—— Breeze/Jetstream 的迁移文件依赖这张表,但脚手架本身不自动执行 - 前端资源必须显式构建:
npm install && npm run build(不是dev,生产部署或首次初始化用build;开发中才用dev并保持进程运行)
Breeze 和 Jetstream 到底该选谁?
别被“高级脚手架”这个词带偏。选型取决于你真正要什么,而不是文档里写了多少功能:
- 只要注册/登录/密码重置,且不想碰 Vue/React:用
composer require laravel/breeze --dev && php artisan breeze:install blade。它不改你已有的 Blade 结构,只加路由和控制器 - 需要团队管理、API Token、2FA、GDPR 删除账户这些开箱即用的功能:Jetstream 是唯一选择,但必须接受它强绑定 Livewire 或 Inertia,并会覆盖
app/Providers/RouteServiceProvider.php中的路由注册逻辑 - 已有用户模型或自定义认证逻辑:Breeze 更安全——它只生成新控制器,不碰你原来的
User类;Jetstream 会往User加 trait,还可能覆盖Authenticatable实现
真正容易被忽略的是:Breeze 默认不启用邮箱验证,Jetstream 默认启用;如果你没配好 MAIL_MAILER,Jetstream 的注册流程会在发邮件那步静默失败,页面只显示“500”,日志里却只有 Connection could not be established with host 这种模糊错误。










