laravel 11项目成功运行需完成三步：环境配置（php≥8.2并启用mbstring等扩展）、显式指定版本创建项目（composer create-project laravel/laravel:^11.0）、生成.env文件及app_key密钥，最后启动服务并验证路由。
想让 Laravel 项目真正跑起来，光下载完还不够——得把环境配对、密钥生成、路由通路这三步走稳。跳过任何一环，浏览器打开就是 500 或白屏。
先确认 PHP 和必需扩展已就位
Laravel 11（当前主流稳定版）要求 PHP ≥ 8.2，且以下扩展必须启用：mbstring、openssl、pdo、tokenizer、xml、ctype、json。缺一个，artisan 命令就会在启动前直接报错，比如 Class 'Mbstring' not found 这类提示，实际是扩展没加载，不是代码写错了。
- 运行 php -v 确认版本 ≥ 8.2.x
- Linux/macOS 执行 php -m | grep -E 'mbstring|openssl|pdo|xml'；Windows 用户打开 php.ini，检查这些 extension= 行是否取消注释
- WAMP/XAMPP 用户可在控制面板里勾选扩展；WSL 或 Ubuntu 可用 sudo apt install php8.2-mbstring php8.2-xml php8.2-sqlite3
用 Composer 创建项目，版本不能靠猜
默认命令 composer create-project laravel/laravel myapp 拉到的仍是 Laravel 10.x，因为 Packagist 的 latest 标签尚未自动切到 v11 stable。必须显式指定版本约束，否则后续踩坑概率极高。
- 推荐写法：composer create-project laravel/laravel:^11.0 myapp --prefer-dist（
--prefer-dist加速下载） - 国内用户务必提前配置镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 装完立刻打开 myapp/composer.json，确认
"laravel/framework": "^11.0"存在，否则说明版本不对
.env 文件和 APP_KEY 是硬性前提
没有 .env，Laravel 连基础配置都读不到；APP_KEY 为空，session、加密、缓存全瘫痪——页面直接报 No application encryption key has been specified。
- 在项目根目录执行：cp .env.example .env（Windows 用 copy .env.example .env）
- 接着运行：php artisan key:generate，它会自动写入有效的 base64 密钥到 .env 的 APP_KEY 行
- 别跳过这步！哪怕只是临时测试，也必须生成真实密钥才能启动
启动服务并验证路由是否生效
artisan serve 启动后，还要确保 APP_URL 匹配访问地址，并且 storage 和 bootstrap/cache 目录有写权限，否则日志、缓存、视图编译都会失败。
- 进入项目目录，运行：php artisan serve（默认监听 http://localhost:8000）
- 检查 .env 中
APP_URL=http://localhost:8000是否一致 - Linux/macOS 执行：chmod -R 755 storage bootstrap/cache；Windows 通常默认可写
- 打开 routes/web.php，把默认路由改成
Route::get('/', function () { return 'Hello, Laravel!'; });，保存后刷新页面看到文字即表示路由通了
