Laravel路由无需安装,它是框架内置功能;关键在于正确安装Laravel框架并确保环境就绪:需PHP≥8.2、启用mbstring等扩展,用composer create-project创建项目,运行php artisan key:generate和php artisan serve,并验证http://localhost:8000是否显示欢迎页。

直接说重点:Laravel 路由本身不需要“安装”,它是框架内置的核心功能;真正需要做的是——在 Windows 10/11 或 macOS 上正确安装 Laravel 框架,并确保项目能正常启动、响应路由请求。很多初学者卡在“访问 http://localhost:8000 显示空白或报错”,根源往往不是路由写错了,而是环境没配好、key 没生成、服务没跑起来。
一、先装对环境,路由才能跑起来
路由依赖整个 Laravel 运行时,而运行时依赖 PHP 和扩展。Laravel 11 要求:
- PHP ≥ 8.2(不能是 8.1 或更低)
- 必须启用:
mbstring、openssl、pdo、tokenizer、xml、ctype、json - Windows 用户别用 phpstudy 自带的旧版 PHP,推荐用 php.net 官方 ZIP 包 解压配置;macOS 推荐
brew install php@8.2+brew services start php@8.2 - 验证是否就绪:
php -v看版本,php -m | grep mbstring(macOS/Linux)或php -m(Windows 查找 mbstring 行)
二、用 create-project 装 Laravel,别碰 laravel new
laravel new myapp 看似方便,实际容易失败:它会先全局安装 laravel/installer,而这个工具版本常滞后,还可能因代理/权限卡住。更稳的做法是跳过中间层,直连 Composer:
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
- 装最新稳定版(当前为 Laravel 11.x):
composer create-project laravel/laravel blog - 装指定版本(如 Laravel 10):
composer create-project laravel/laravel blog "10.*" - 网络慢?先换国内镜像:
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
三、装完必做三件事,否则路由 404 或报错
项目目录生成后,别急着 php artisan serve。以下三步缺一不可:
-
生成应用密钥:
cd blog && php artisan key:generate—— 否则 Session、CSRF、加密全部失效,首页都打不开 -
检查 .env 文件:确认
APP_URL=http://localhost:8000,数据库配置可先留空(路由不依赖 DB) -
启动开发服务器:
php artisan serve(默认监听http://127.0.0.1:8000),不是php -S或 XAMPP 的 Apache
四、验证路由是否生效(两个最简测试)
打开浏览器访问以下地址,看是否返回预期内容:
-
http://localhost:8000→ 应显示 Laravel 欢迎页(对应routes/web.php中的/路由) -
http://localhost:8000/test→ 在routes/web.php末尾加一行:Route::get('/test', function () { return 'Hello from route!'; });,保存后刷新即见效果 - 如果 404,请检查:artisan 是否在项目根目录运行?.env 中
APP_DEBUG=true是否开启?终端有无报错输出?










