Telescope 是 Laravel 官方调试工具，支持请求、日志、SQL 等实时监控，安装只需 composer require 和 artisan 命令，本地环境默认启用，提供界面化筛选与手动记录功能。
Telescope 是 Laravel 官方推出的调试工具，专为开发环境设计，能实时捕获请求、日志、数据库查询、缓存、队列、异常等详细信息。安装简单，界面直观，不需要额外配置数据库（默认用文件存储），适合快速定位问题。
安装 Telescope
在 Laravel 项目根目录执行以下命令：
运行
composerrequirelaravel/telescope --dev
（仅开发环境需要）
执行
phpartisan telescope:install
（发布迁移和配置）
运行
php artisan migrate
（若使用数据库存储；如跳过此步，默认会用
目录存 JSON 文件）
启动服务：
php artisan serve
，然后访问
/telescope
（例如 http://localhost:8000/telescope）
启用 Telescope
路由
和权限控制
默认情况下，Telescope 只对本地环境（
）开放。如需自定义访问权限，可编辑
中的
方法：
允许所有本地请求：保持默认的
限制为特定 IP 或用户：比如只让管理员访问，可改成
，并配合 Gate 定义权限
注意：生产环境切勿开启 Telescope，它会显著影响性能且存在安全风险
查看和筛选调试数据
打开
/telescope
后，你会看到时间线式的数据列表。常用操作包括：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
点击某条请求，展开详情页——能看到完整的请求头、响应内容、中间件执行顺序、SQL 查询（含绑定参数和执行时间）、日志行、事件广播、缓存操作等
顶部搜索栏支持按 URI、方法（GET/POST）、
状态码
、标签（tag）、异常关键词过滤
右侧「Filters」可勾选类型（如只看 Queries 或 Exceptions），也可输入自定义标签（比如在代码中用
标记关键流程）
每条记录右上角有「Prune」按钮，可手动清理单条记录（不影响其他数据）
在代码中主动记录调试信息
除了自动采集，你还可以手动记录变量、调试语句或自定义事件：
记录普通变量：
（会在 Dump 标签下显示）
记录自定义监控项：
给某段逻辑加标签，方便筛选：
（放在该逻辑开始前）
临时关闭采集（比如避免日志爆炸）：
，之后调用
恢复
基本上就这些。Telescope 不复杂但容易忽略细节——比如忘记清空旧数据导致加载变慢，或者没关掉生产环境访问。日常开发中，它比 dd() 和日志更系统，也比 Xdebug 更轻量。
storage/telescopeAPP_ENV=localapp/Providers/TelescopeServiceProvider.phpgate()return $request->isLocal();return $request->user()?->can('viewTelescope');Telescope::tag(['api', 'payment'])Telescope::recordDump($user, $order);Telescope::recordMessage('Payment processed', 'info', ['order_id' => 123]);Telescope::tag(['checkout']);Telescope::stopRecording();Telescope::startRecording();