Laravel源码包解压后不可直接运行，必须执行四步：1.在项目根目录运行composer install补全vendor依赖；2.复制.env.example为.env；3.运行php artisan key:generate生成APP_KEY并开启APP_DEBUG=true；4.用php artisan serve启动或配置Web服务器指向public目录，同时赋予storage和bootstrap/cache写权限。
直接解压 Laravel 源码包（比如从官网或国内镜像下载的一键安装包）只是第一步，它不等于可运行项目。必须补全依赖、配置和权限，否则访问会报 500、空白页或 “Whoops” 错误。核心操作就四步，缺一不可。
1. 安装 Composer 依赖
解压后的文件夹里没有 vendor 目录，所有 PHP 类库（包括框架核心）都靠 Composer 下载。必须在项目根目录（即含 composer.json 的那层）执行：
-
composer install（推荐，按composer.lock精确还原） - 或
composer update（重新解析依赖，适合二次开发）
若提示 command not found，说明本地没装 Composer；若卡在下载，建议先切国内镜像：composer config -g repo.packagist https://packagist.phpcomposer.com
2. 配置 .env 文件
Laravel 运行前必须有 .env 文件。它不存在于源码包中，需手动创建：
- 复制
.env.example→ 重命名为.env - 确保该文件位于项目根目录（与
artisan同级） - 关键项如
APP_KEY先留空，后续由命令生成
注意：Windows 资源管理器可能隐藏扩展名，重命名时务必确认是 .env，不是 .env.txt。
3. 生成 APP_KEY 并启用调试
运行 php artisan key:generate，会自动写入 APP_KEY=xxx 到 .env。这一步失败，页面必报 “No supported encrypter found”。
同时建议临时开启调试模式，方便定位问题：
- 打开
config/app.php - 找到
'debug' => env('APP_DEBUG', false), - 改为
'debug' => env('APP_DEBUG', true), - 并在
.env中确保APP_DEBUG=true
4. 设置 Web 服务器入口和目录权限
浏览器不能直接访问项目根目录，必须指向 public/ 子目录：
- 本地开发：用内置服务器，运行
php artisan serve，访问http://localhost:8000 - 配 Apache/Nginx：DocumentRoot 设为
/path/to/laravel/public
另外两个目录需写权限（尤其 Windows + XAMPP/WAMP 场景）：
-
storage/及其所有子目录（日志、缓存、session） -
bootstrap/cache/（配置缓存）
Linux/macOS 可用 chmod -R 775 storage bootstrap/cache；Windows 下右键属性 → 安全 → 编辑权限即可。
