Laravel如何使用Telescope进行调试？（安装和使用教程）

Telescope 是 Laravel 官方调试工具，支持请求、日志、SQL 等实时监控，安装只需 composer require 和 artisan 命令，本地环境默认启用，提供界面化筛选与手动记录功能。

Telescope 是 Laravel 官方推出的调试工具，专为开发环境设计，能实时捕获请求、日志、数据库查询、缓存、队列、异常等详细信息。安装简单，界面直观，不需要额外配置数据库（默认用文件存储），适合快速定位问题。

安装 Telescope

在 Laravel 项目根目录执行以下命令：

• 运行 composer require laravel/telescope --dev（仅开发环境需要）
• 执行 php artisan telescope:install（发布迁移和配置）
• 运行 php artisan migrate（若使用数据库存储；如跳过此步，默认会用 storage/telescope 目录存 JSON 文件）
• 启动服务：php artisan serve，然后访问 /telescope（例如 http://localhost:8000/telescope）

启用 Telescope 路由和权限控制

默认情况下，Telescope 只对本地环境（APP_ENV=local）开放。如需自定义访问权限，可编辑 app/Providers/TelescopeServiceProvider.php 中的 gate() 方法：

• 允许所有本地请求：保持默认的 return $request->isLocal();
• 限制为特定 IP 或用户：比如只让管理员访问，可改成 return $request->user()?->can('viewTelescope');，并配合 Gate 定义权限
• 注意：生产环境切勿开启 Telescope，它会显著影响性能且存在安全风险

查看和筛选调试数据

打开 /telescope 后，你会看到时间线式的数据列表。常用操作包括：

标签： php laravel js json composer app 工具 路由 状态码 开发环境 gate