最稳妥方式是用 composer create-project 直接指定语义化版本号,如 "10.*" 或 "10.48.2";laravel/installer 不支持任意版本参数,且默认拉最新版而非 LTS 版。

用 composer create-project 指定 Laravel 版本
直接指定版本号是最稳妥的方式,Laravel 官方不推荐用 laravel/installer 创建带版本约束的项目,因为它的全局命令默认拉最新稳定版,且对旧版本支持不透明。
常见错误是写错版本格式,比如漏掉 v、多加空格、或误用分支名(如 master)代替语义化版本。
- 安装 Laravel 10.x(当前 LTS):
composer create-project laravel/laravel myapp "10.*" - 安装 Laravel 11(最新稳定版):
composer create-project laravel/laravel myapp "11.*" - 安装特定小版本(如 10.48.2):
composer create-project laravel/laravel myapp "10.48.2" - 想装开发分支(不建议生产):
composer create-project laravel/laravel myapp "dev-main",但需确认仓库允许 dev 包下载
注意:双引号必须保留,否则 shell 可能提前解析 * 导致报错 Could not find package laravel/laravel with version *。
LTS 版本怎么选?看官方支持周期,不是看“最新”
Laravel 的 LTS 版本(如 9.x、10.x)有 2 年主维护 + 1 年安全更新,非 LTS 版本只维护 6 个月。选错版本可能导致半年后就收不到安全补丁。
目前(2024 年中)有效的 LTS 是 10.x(2022.02 发布,主维护至 2024.02,安全更新至 2025.02),11.x 不是 LTS。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查当前 LTS 列表最准方式:Laravel 官方发布页,别信第三方整理
-
composer create-project laravel/laravel myapp不加版本号 → 默认拉最新稳定版,**不是 LTS** - 如果项目要上线半年以上,别图省事,默认版本大概率不是你想要的长期支持版
为什么 laravel new 不适合指定版本?
laravel/installer 是个封装工具,它内部调用 create-project,但版本逻辑写死在 installer 自身代码里 —— 它只认 --dev 或不带参数两种模式,不接受任意版本字符串。
执行 laravel new myapp --version=10 会报错 Unknown option: --version,这是 installer 的硬限制,不是你命令输错了。
- 想用
laravel new只能接受它内置的版本映射(比如laravel new myapp --dev拉dev-main) - 要精确控制版本,绕过 installer,直用
composer create-project - 已全局装了
laravel/installer?卸载它反而更干净:composer global remove laravel/installer
安装失败常见原因和绕过方法
报错 Could not find package laravel/laravel 多半是网络或镜像问题,Composer 默认走 packagist.org,国内用户常卡在 DNS 或连接阶段。
- 临时切国内镜像:
composer config -g repo.packagist composer https://packagist.phpcomposer.com(注意该镜像已停更,推荐用https://packagist.laravel-china.org) - 清缓存再试:
composer clear-cache,尤其换版本时旧包可能被缓存干扰 - PHP 版本不匹配会静默失败:Laravel 10 要求 PHP >= 8.1,
php -v确认后再操作 - 权限问题(Linux/macOS):避免用
sudo composer,改用正确的用户权限运行
版本号写对了、网络通了、PHP 对了,还失败?检查 composer.json 里有没有自定义 repositories 干扰了包源,这种配置容易被遗忘。

















