Laragon 下 Laravel 日志默认写入 storage/logs/laravel.log,路径为项目根目录(如 C:\laragon\www\myapp)下的 storage\logs;需确保 LOG_CHANNEL 设置正确、APP_DEBUG=true、目录非只读,并可用 VSCode 或 tail -f 实时查看。

Laragon 是 Windows 下常用的本地开发环境,运行 Laravel 项目时,日志默认仍写入 storage/logs/laravel.log,和标准 Laravel 部署行为一致。关键不是环境特殊,而是路径可访问、文件可读、内容实时。
直接打开 storage/logs 查看日志文件
- Laragon 的项目根目录就是你放 Laravel 代码的地方(比如
C:\laragon\www\myapp) - 进入该目录 → 找到
storage\logs文件夹 → 双击laravel.log即可用记事本或 VSCode 打开 - 如果启用了
daily日志通道,会看到类似laravel-2026-08-17.log的文件,按日期选最新即可
注意权限与生成前提
- Laragon 默认以当前 Windows 用户身份运行 PHP 和 Apache/Nginx,一般无需额外授权,但若日志文件始终为空,需确认:
-
.env中LOG_CHANNEL=stack或single已设置,且未被缓存覆盖(改完后运行php artisan config:clear) -
APP_DEBUG=true已开启(开发阶段必须),否则 debug/info 级别日志会被跳过 -
storage/logs目录存在且非只读;偶尔因杀毒软件或系统策略被锁定,可右键属性 → 取消“只读”勾选
-
用 Laragon 自带终端快速查看
- 在 Laragon 主界面右键你的项目 → “Open Terminal”
- 输入以下命令实时追踪日志:
tail -f storage/logs/laravel.log
(如提示
tail不是内部命令,说明 Windows 命令行不支持;此时改用 Git Bash 或在 Laragon 终端中安装coreutils,或直接用 VSCode + Log File Highlighter 插件替代)
配合浏览器调试更高效
- 提交表单或触发报错后,立即切回
laravel.log,搜索[ERROR]、Exception、SQLSTATE等关键词 - 错误行通常带时间戳和完整堆栈,例如:
[2026-08-17 11:02:33] local.ERROR: SQLSTATE[23000]: Integrity constraint violation...
这类信息比页面 500 更具体,能直指数据库约束、字段缺失或验证逻辑问题
不复杂但容易忽略,重点就是路径对、权限通、级别开、工具顺手。


















