laravel的log门面默认可用，但日志等级控制、多通道输出、文件轮转和敏感信息过滤需配置config/logging.php；info日志用log::info('msg', $context)，注意环境差异与权限问题。
直接说结论：Laravel 的 Log 门面默认就可用，不用额外配置就能写日志；但日志等级控制、多通道输出、文件轮转和敏感信息过滤，得靠改 config/logging.php 和理解底层驱动行为。
怎么快速写一条 info 日志？
最常用也最容易出错的其实是「以为写了就一定进文件」。Laravel 默认在 APP_ENV=local 时写入 storage/logs/laravel.log，但生产环境（APP_ENV=production）默认用 stack 驱动，实际可能走 daily 或 stderr，取决于配置。
-
Log::info('用户登录成功', ['user_id' => 123]);—— 推荐带上下文数组，方便结构化检索 - 别用
echo或dd()替代日志，尤其在队列或命令行任务里，它们根本不会落地 - 如果没看到日志，先检查
storage/logs/目录权限是否为 755 且 web server 可写
debug/info/warning/error 这些等级怎么选？
等级不是按「严重程度」粗略划分，而是和后续处理强绑定。比如 error 级别会触发 Slack/Webhook 通知（如果你配了），而 debug 在生产环境默认被丢弃。
-
Log::debug()：仅开发环境有效，生产环境即使开了LOG_LEVEL=debug，也建议关掉——量太大易拖慢性能 -
Log::warning()：用于可恢复的异常，比如第三方 API 返回 404 但有降级逻辑 -
Log::error()：必须人工介入的问题，如数据库事务失败、支付回调验签失败 - 别滥用
Log::emergency()或Log::alert()，这些会触发系统级告警，多数项目根本没接通对应通道
怎么让不同日志写到不同文件？
靠自定义 channel，不是靠改 Log::xxx() 的调用方式。核心是编辑 config/logging.php，加一个以 daily 或 single 为 driver 的新 channel。
/*
* config/logging.php 内追加：
*/
'channels' => [
// ...
'payment' => [
'driver' => 'daily',
'path' => storage_path('logs/payment.log'),
'level' => 'debug',
'days' => 14,
],
],- 然后用
Log::channel('payment')->info('支付请求发出'); - 注意：每个 channel 是独立实例，
level和handler不共享 - 如果想让某个 channel 同时推送到 Sentry，就在它的配置里加
'tap' => [App\Logging\SentryTap::class]
为什么有些日志内容被自动脱敏了？
Laravel 7+ 默认启用了日志敏感字段过滤，只要字段名匹配 password、token、secret 等关键词，值就会变成 ***。这个行为在 Illuminate\Log\Logger 中硬编码，不走配置。
- 查看过滤列表：源码里搜
$this->dontDisplaySensitiveFields - 自定义过滤需重写
createPdoHandler()或继承Logger，但更推荐在打日志前手动处理：Log::info('登录请求', ['email' => $request->email, 'password' => '[hidden]']); - 别依赖日志查原始密码或 token——这本身就不符合安全规范
真正容易被忽略的是：日志轮转（daily 驱动）依赖系统时间而非写入时间，跨月日志可能混在一个文件里；还有就是队列任务中用 Log::stack() 时，上下文变量可能因序列化丢失，得显式传参。
