最稳妥方式是用 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。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 查当前 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 干扰了包源，这种配置容易被遗忘。
