laravel 10 应使用 composer create-project laravel/laravel:^10.0 myapp 安装,而非已归档且不维护的 laravel/installer;需确保 php ≥ 8.1、启用必需扩展,并执行 php artisan key:generate 和缓存清理。

Laravel Installer 是一个独立的命令行工具,但它已不再推荐用于安装 Laravel 10+。自 Laravel 9 起,官方明确弃用 laravel/installer(即 laravel new 命令),转而统一使用 Composer 的 create-project 方式——更可控、版本明确、无需额外全局安装。
所以严格来说:你不需要、也不应该用 Laravel Installer 安装 Laravel 10。直接用 Composer 即可,更可靠、更符合当前标准。
✅ 正确安装 Laravel 10 的方式(推荐且唯一主流方式)
composer create-project laravel/laravel:^10.0 myapp
-
^10.0显式锁定 Laravel 10 系列(LTS 版本),避免误装 Laravel 11(需 PHP 8.2+) -
myapp是项目目录名,可按需修改
⚠️ 注意:运行前务必确认:
- PHP ≥ 8.1(执行
php -v查看)- 必备扩展已启用:
mbstring,openssl,pdo,tokenizer,xml,ctype,json,intl(执行php -m | grep -E 'mbstring|openssl|pdo|tokenizer|xml|ctype|json|intl'验证)
❌ 为什么不要用 laravel/installer?
-
laravel/installer已归档(Archived),不再维护(GitHub 官方仓库状态为archived) - 它内部仍调用
create-project,但会隐藏版本细节,容易拉到不兼容的 Laravel 11 或 dev 分支 - 在国内网络环境下,
laravel new myapp常因镜像未配置或内存不足而卡死、报 zlib 错误,排查困难 - 官方文档(laravel.com/docs/10.x/installation)全程只推荐
create-project
? 如果你已全局安装过 laravel/installer,建议卸载
composer global remove laravel/installer
然后用标准方式安装:
# 确保 Composer 镜像已切国内(推荐腾讯云) composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ # 创建 Laravel 10 项目(加内存限制防卡) COMPOSER_MEMORY_LIMIT=-1 composer create-project laravel/laravel:^10.0 myapp # 进入项目,生成密钥(必须!否则白屏) cd myapp php artisan key:generate # 清理缓存(防止旧配置干扰) php artisan config:clear && php artisan cache:clear
? 安装后必做三件事
- 检查
.env中APP_KEY是否已生成(php artisan key:generate后自动写入) - 设置
APP_URL=http://localhost:8000(开发时勿用127.0.0.1) - 执行
php artisan serve启动服务,访问http://localhost:8000验证首页
不复杂但容易忽略











