log

log 可以发现或打开日志文件，读取受限的开头或结尾，并在不把持续增长的日志全部载入内存的情况下过滤行。

诊断版本 1.2.2稳定
lil-terminal

概览

用 log 做定向排查：找到正确文件，选择开头或结尾，再按需过滤字面文本。命令不会修改日志。

先缩小日志范围再阅读

运行日志会持续增长，通常远多于一次诊断真正需要的数据。log 把任务缩小为文件、有限窗口和过滤条件；在共享主机上，这比用编辑器打开大日志更快也更稳妥。

语法

lil-terminal
log [file] [options]

参考

log

显示自动检测到的最新日志最后 10 行

log <file>

显示指定日志文件最后 10 行

-h

显示开头若干行而不是末尾

-n <lines>

设置显示行数，范围 1–50000

-g <text>

只显示包含 <text> 的行

-i

忽略大小写搜索 <text>

-l

列出检测到的日志文件

自动检测

自动检测会在少量邻近位置识别 error_log、error.log、debug.log、app.log、access.log、laravel.log 等常见名称。log -l 使用统一的结构化表格：路径占用宽大的左列，修改时间与大小在右侧保持整齐对齐。

读取与过滤

默认读取文件末尾。-h 改为开头，-n 限制行数，-g 按字面文本过滤，-i 忽略大小写。大文件采用流式读取。

安全

log 永远不会写入所选文件。二进制文件会被拒绝，所有路径仍经过 lil-terminal 的常规文件系统解析器。

交互式 sandbox 预览

可直接在页面中运行预先准备的示例。结果已预先生成并在浏览器中显示；服务器不会执行任何终端命令。

找到日志并读取简短尾部

安装与管理

安装当前兼容版本。完整功能请选择 Base，精简包请选择 Minimum；已安装模块的更新请使用 upgrade。

Base 与 Minimum 是同一当前模块版本的两个包。

Base 包

安装包含本地参考和全部已发布模式的完整包。

install log
Minimum 包

安装精简包。该包不包含本地参考；help <cmd> -i 会打开当前服务器参考。

install log -m
精确公开版本

安装这个确切的已发布版本。

install log -v 1.2.2
检查或升级

让 upgrade 检查兼容性，仅在需要时替换已安装块。

upgrade log
删除模块

删除扩展块，不影响核心和其他模块。

install log -u

示例

示例可复制，但网站不会执行。请先检查路径、权限和破坏性选项。

找到日志并读取简短尾部
cd \sandbox | log -l | log logs/app.log -n 2
2026-08-08 20:53:40    219 B    ~/logs/errors.log
2026-08-07 12:00:00     96 B    ~/logs/app.log

2026-08-07 12:00:02 INFO request completed
2026-08-07 12:00:03 DEBUG cache hit
显示指定日志文件最后 10 行
log sandbox/logs/app.log
File: sandbox/logs/app.log

2026-01-01T00:00:00Z INFO sandbox initialized
2026-01-01T00:00:01Z DEBUG sample event completed
显示开头若干行而不是末尾
log sandbox/logs/app.log -h
File: sandbox/logs/app.log

2026-01-01T00:00:00Z INFO sandbox initialized
2026-01-01T00:00:01Z DEBUG sample event completed
设置显示行数，范围 1–50000
log sandbox/logs/app.log -n 1
File: sandbox/logs/app.log

2026-01-01T00:00:01Z DEBUG sample event completed
只显示包含 <text> 的行
log sandbox/logs/app.log -g DEBUG
File: sandbox/logs/app.log
Filter: DEBUG

2026-01-01T00:00:01Z DEBUG sample event completed
忽略大小写搜索 <text>
log sandbox/logs/app.log -g debug -i
File: sandbox/logs/app.log
Filter: debug

2026-01-01T00:00:01Z DEBUG sample event completed
列出检测到的日志文件
log -l
sandbox/logs/errors.log              2026-08-08 16:20:57  219 B
sandbox/logs/app.log                 2026-08-04 23:53:00   96 B
处理不存在的日志文件
log sandbox/logs/missing.log
未找到日志文件

本示例使用的文件: sandbox/logs/app.log

该示例使用受保护的 /sandbox/ 文档工作区中的文件或目录。

2026-01-01T00:00:00Z INFO sandbox initialized
2026-01-01T00:00:01Z DEBUG sample event completed

相关文档

服务器需要满足哪些条件？ →为什么大文件和大量输出会受限制？ →

当前公开版本

v1.2.22026-08-10

对齐的日志列表

log -l 从左到右显示日期、大小和路径，并将选项集中整理。

# 版本历史