本文详细讲解如何仅凭本地已有的 laravel 项目文件，在 windows 上使用 laragon 快速搭建可运行的本地开发环境，包括数据库导入、迁移执行与服务启动全流程。
当你接手一个 Laravel 网站却无法访问原服务器时，只要拥有完整的项目文件（含 app/、database/、.env、composer.json 等），就完全可以在本地实现 100% 功能复现——关键在于正确还原运行时依赖、配置和数据状态。
✅ 基础准备：安装 Laragon（推荐 Windows 用户）
Laragon 是专为 Windows 设计的轻量级集成开发环境，内置 Apache/Nginx、PHP、MySQL 和 phpMyAdmin/HeidiSQL，开箱即用，比手动配置 WAMP 或 Docker 更高效（尤其对非 DevOps 背景的开发者）。
? 下载地址：https://www.php.cn/link/c801fb350a465fe48197dda942b8091a
安装后启动 Laragon，确保系统托盘中显示绿色「Running」状态。
? 步骤一：部署项目代码
- 在 C:\laragon\www\ 目录下新建一个空文件夹（如 my-laravel-site）；
- 将你手头的全部 Laravel 文件（务必包含隐藏文件，尤其是 .env 和 .gitignore）完整复制进去；
- ⚠️ 注意：若原 .env 中含有线上数据库密码或 API 密钥，请立即修改为本地安全值（如 DB_PASSWORD= 留空或设为 root），并确认 APP_KEY 存在（若缺失，后续需生成）。
?️ 步骤二：初始化数据库
- 在 Laragon 主界面点击 MySQL → HeidiSQL（或通过菜单打开）；
- 连接默认 localhost（用户 root，密码为空）；
- 新建数据库：右键「localhost」→「Create new database…」→ 输入库名（如 laravel_site），字符集选 utf8mb4_general_ci；
- 若你有原站导出的 SQL 备份（如 backup.sql），可在 HeidiSQL 中右键该数据库 → 「Execute SQL file…」一键导入；
- 若无备份，仅靠迁移文件重建结构：跳至下一步执行 php artisan migrate。
⚙️ 步骤三：安装依赖并运行迁移
以管理员权限打开 Laragon 自带的终端（点击左上角 Terminal → CMD 或 Git Bash）：
# 进入项目目录 cd C:\laragon\www\my-laravel-site # 安装 PHP 依赖（确保已安装 Composer） composer install # 生成应用密钥（若 .env 中 APP_KEY 为空） php artisan key:generate # 执行数据库迁移（创建表结构） php artisan migrate # 【可选】填充测试数据（如有 seeders） php artisan db:seed
▶️ 步骤四：启动服务并验证
- 回到 Laragon 主界面，点击右上角 Reload 按钮（或按 Ctrl+R）；
- Laragon 会自动识别 Laravel 项目并启用对应虚拟主机（默认访问地址：http://my-laravel-site.test）；
- 打开浏览器访问该地址，应看到 Laravel 欢迎页或原站首页；
- 如遇 500 错误，请检查 storage/logs/laravel.log，常见原因包括：
? 后续建议
- 本地调试完成后，使用 php artisan config:clear、php artisan cache:clear 清理缓存再打包；
- 上传至新主机前，务必更新 .env 中的 APP_URL、数据库连接及缓存驱动配置；
- 如需跨平台协作或长期维护，建议将此流程容器化（Docker Compose），但 Laragon 方案已足够应对绝大多数紧急修复场景。
你已成功将一个“离线”的 Laravel 网站转化为完全可控的本地开发实例——这不仅是技术复原，更是掌控项目生命周期的关键一步。
