最干净可靠的 Laravel 安装方式是直接使用 composer create-project laravel/laravel myapp "11.*"，无需全局安装 laravel/installer；需确保 PHP ≥ 8.2 并启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json 七个扩展；国内用户务必配置阿里云镜像源；安装后必须执行 cp .env.example .env 和 php artisan key:generate 才能正常启动。
直接用 composer create-project，别碰 laravel/installer
现在装 Laravel 最干净、最可靠的方式就是一条命令搞定，不需要提前装全局安装器。那个 laravel/installer 不仅早已过时，还容易和你本地的 Composer 全局配置冲突，导致版本错乱或命令不响应。
- 正确做法：
composer create-project laravel/laravel myapp "11.*"（Laravel 11 要求 PHP ≥ 8.2） - 想装 Laravel 10？把版本号换成
"10.*"；要精确到小版本，比如"9.52.16"也完全支持 -
"10.*"必须加英文引号，否则 shell 会把*当前目录文件名展开，报错Could not find package laravel/laravel with version 10. - 不用手动建目录、不用改
composer.json，项目结构、依赖、自动加载全由 Composer 一步拉齐
PHP 版本和扩展缺一不可，报错不是代码问题而是环境没配好
很多人看到 RuntimeException: The use statement with aliasing is not allowed here 就去查语法，其实根本不是 PHP 代码写错了——是 tokenizer 扩展没开。Laravel 11 强制要求 PHP ≥ 8.2，并启用 mbstring、openssl、pdo、tokenizer、xml、ctype、json 这七个扩展，少一个就卡在 autoload 或启动阶段。
- 检查 PHP 版本：
php -v - 检查扩展是否加载：
php -m | grep -E 'mbstring|openssl|pdo|tokenizer|xml|ctype|json' - Windows 用户注意：XAMPP/MAMP 自带的
php.ini默认注释掉了很多扩展，得手动删掉前面的分号，改完必须重启服务 - Linux/macOS 用户如果用
apt或brew装的 PHP，可能需要额外执行sudo phpenmod mbstring openssl tokenizer类似命令
国内用户不切镜像源，90% 概率卡死在 Installing dependencies
Composer 默认走海外 packagist.org，国内直连大概率超时或反复重试，表现就是卡在 Installing dependencies 超过 2 分钟，最后报 Connection timed out 或干脆中断。
- 必须执行一次全局镜像切换：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist，输出应为阿里云或腾讯云地址 - 如果之前失败过，先删掉半成品目录（如
myapp），再重跑create-project，否则 Composer 可能复用损坏的缓存 - 切完镜像后，完整安装通常能在 30 秒内完成，快慢立判
装完不能直接访问，三件事漏一不可
跑完 composer create-project 只是把代码拉下来，不代表能跑起来。白屏、“Whoops” 错误、500 页面，八成是因为跳过了这三步。
- 进项目目录：
cd myapp - 复制环境文件：
cp .env.example .env - 生成密钥：
php artisan key:generate（这步必须做，否则 session、cookie 加密失败，页面直接崩） - 做完以上才能跑
php artisan serve，访问http://127.0.0.1:8000看欢迎页
storage 和 bootstrap/cache 目录权限问题常被忽略，尤其在 WSL 或 Docker 环境里，如果后续报“failed to open stream: Permission denied”，就得手动补一句 chmod -R 755 storage bootstrap/cache。
