ThinkPHP6日志模块默认初始化，无需手动调用即可自动记录错误、SQL等；首页自定义日志直接用Log::info()等静态方法即可，但需确保app_debug=true、目录可写且log配置正确。
ThinkPHP6里日志模块默认就开着，不用“调用”也能自动记录
很多人搜“首页如何调用日志模块”，其实是误解了日志的使用逻辑——Log 不是像控制器或模型那样需要手动实例化、显式调用才能生效的模块。TP6 的日志系统在框架启动时已初始化，所有 think\Log 写入操作（包括系统自动记录的错误、SQL、调试信息）都走统一通道。
如果你只是想让首页访问时留下一条自定义日志，直接用静态方法写就行：
<pre class="brush:php;toolbar:false;">// 在 index 控制器的 index 方法里
\think\Log::info('首页被访问了', ['ip' => $this->request->ip(), 'ua' => $this->request->header('user-agent')]);
注意：\think\Log 是门面类，背后实际调用的是 <code>think\log\driver\File（默认驱动），无需 new 实例，也不用提前 use（除非 IDE 提示或你开了严格命名空间检查）。
日志写不进文件？先看配置和目录权限
常见现象：代码写了 \think\Log::error('test')，但 runtime/log/ 下没生成新文件，或只有日期目录没日志文件。
立即学习“PHP免费学习笔记（深入）”；
-
app_debug必须为true（开发环境默认开启），否则日志等级低于warning的不会写入 -
runtime/log/目录需有写权限（Linux 下常见是www-data或nginx用户无权限） - 检查
config/log.php中'default'驱动是否为'file'，且'path'指向正确路径（默认就是runtime/log/） - 如果用了多级目录（如
'path' => '../logs/'），确保路径是相对于入口文件（public/index.php）的绝对路径，或用Env::get('root_path') . 'logs/'
想在首页输出日志内容？别直接读 runtime 文件
有人想“在首页展示最近 10 条日志”，这容易踩坑：
- 日志文件是按天切割的（如
2024-06-15.log），直接file_get_contents读取可能遇到权限拒绝、文件锁、编码乱码（TP6 日志默认 UTF-8，但 Windows 记事本可能识别错） - 日志内容含敏感信息（SQL、token、用户数据），暴露在前端极危险
- 大日志文件（>10MB）会导致首页响应卡顿甚至超时
真有查看需求，建议单独建一个带鉴权的后台日志页面，用 Log::getLog() 获取内存中本次请求的日志（仅限当前请求上下文），或用第三方工具（如 monolog + elk）做集中管理。
日志等级和性能影响不能忽略
在首页高频写日志（比如每访问一次就 Log::info() 一次）会影响性能，尤其当磁盘 I/O 繁忙时：
-
Log::debug()和Log::info()默认只在app_debug = true时生效；生产环境设为false后，这些调用会被跳过，几乎零开销 - 但
Log::error()、Log::alert()、Log::critical()即使在app_debug = false下也会写入（这是设计行为） - 如果首页要埋点统计，建议用 Redis 计数或异步队列，而不是同步写日志文件
最常被忽略的一点：日志驱动切换成本低，但改完配置后必须清空 runtime/cache/，否则旧配置可能被缓存，导致日志不生效或写错位置。
