.env文件丢失不严重,可复制.env.example生成并重命名;必须立即执行php artisan key:generate生成APP_KEY,否则因加密组件初始化失败而报错。

.env 文件丢失不是严重问题,Laravel 项目自带 .env.example 作为模板,可快速重建。关键在于补全后必须执行必要命令,否则项目仍无法运行。
从 .env.example 复制生成新 .env
项目根目录下一定存在 .env.example(Laravel 安装时默认创建)。只需复制它并重命名为 .env:
- Windows 命令行:
copy .env.example .env - macOS / Linux 终端:
cp .env.example .env - 图形界面:显示隐藏文件(如 Finder 或文件管理器中启用“显示隐藏项”),手动复制粘贴并改名
立即生成 APP_KEY 并验证基础配置
.env 生成后不能直接运行,因为 APP_KEY 为空会导致 Laravel 加密组件初始化失败,报错 “Missing APP_KEY and no cipher is set”。必须立刻执行:
- 运行
php artisan key:generate—— 这会自动写入有效的APP_KEY=base64:... - 检查
config/app.php中'cipher' => 'AES-256-CBC'是否存在且未被注释 - 确认
APP_ENV=local和APP_DEBUG=true已设为开发状态,便于排查后续问题
补充数据库等关键配置项
.env.example 只提供占位值,需按本地环境实际填写:
-
DB_DATABASE:填你已创建的数据库名(如laravel_site) -
DB_USERNAME和DB_PASSWORD:对应 MySQL 登录凭据(Laragon/XAMPP 默认是root+ 空密码) -
DB_HOST和DB_PORT:本地常用127.0.0.1:3306;Docker 或远程库需核对真实地址与端口 - 改完务必运行
php artisan config:clear,否则旧缓存可能让新配置不生效
依赖安装与服务启动
确保 PHP 扩展和 Composer 已就绪,再执行:
-
composer install—— 恢复vendor/目录(GitHub 克隆项目必做) -
php artisan migrate—— 创建数据表(前提是你有迁移文件且数据库已就位) - 启动 Web 服务器(如 Laragon 点 “Start All”,或用
php artisan serve)


















