本地安装 Laravel 后必须正确配置 .env 文件，先执行 cp .env.example .env 生成基础文件，再运行 php artisan key:generate 写入 APP_KEY，接着配置数据库连接、APP_ENV、APP_DEBUG、APP_URL 等参数，最后清缓存并启动服务验证。
本地安装 Laravel 后必须正确配置 .env 文件，否则项目无法启动或数据库连接失败，APP_KEY 缺失会导致加密组件初始化失败，直接报 Missing APP_KEY and no cipher is set。
生成基础 .env 文件
进入项目根目录，执行 cp .env.example .env。这一步不能跳过——Laravel 启动时只认 .env，不读 .env.example。
【.env 文件必须位于项目根目录下，且文件名全小写、无扩展名】
生成并写入 APP_KEY
运行 php artisan key:generate。该命令会自动生成 32 字节 base64 编码密钥，并写入 .env 中的 APP_KEY 行。
如果提示 “Application key set successfully”，说明已写入；若提示 “No application encryption key has been specified”，说明上一步没成功或 .env 不可写。此时检查当前用户对 .env 的写权限，或手动添加一行：APP_KEY=base64:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx（长度必须为 44 字符）。
配置数据库连接
打开 .env 文件，修改以下五项：
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_local_db_name
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password
注意：DB_HOST 写 localhost 和 127.0.0.1 在本地 MySQL 中行为可能不同——某些系统下 localhost 走 socket 连接，而 127.0.0.1 走 TCP，权限策略也不同。建议统一用 127.0.0.1，避免权限拒绝错误。
如果使用 Docker 或 MAMP/XAMPP，请确认 DB_PORT 是否被映射为非默认端口（如 3307），漏改此处将导致连接超时。
设置基础应用参数
① 将 APP_ENV 改为 local，确保开发环境标识生效。
② APP_DEBUG 必须设为 true，否则异常页面不显示堆栈，调试寸步难行。
③ APP_URL 设为 http://localhost:8000（或你实际使用的地址，如 http://127.0.0.1:8000），它影响 asset() 生成路径和 CSRF token 验证。
④ 如果用 Mailhog 或 SMTP 测试邮件，补全 MAIL_MAILER、MAIL_HOST 等字段；否则可暂不修改。
⑤ 检查 APP_NAME 是否含中文或特殊符号，如有，用英文重命名，避免 config 缓存失败。
验证并启用配置
执行 php artisan config:clear 清除旧缓存——哪怕这是第一次配置，也要清，因为 Laravel 可能已加载过空配置。
运行 php artisan serve 启动内置服务器，访问 http://localhost:8000。若首页正常显示，且数据库迁移可用（php artisan migrate 不报错），说明 .env 配置完成。
