# biglogview **Repository Path**: wasdzy/biglogview ## Basic Information - **Project Name**: biglogview - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-16 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # BigLogView > VS Code 里的**超大文件查看器**——打开、搜索、过滤、跟踪多 GB 的日志、JSON Lines、CSV 和纯文本文件,全程不把文件载入内存。 可以从 VS Code 插件市场安装,也可以装打包好的 `biglogview-*.vsix`。本项目 fork 自 **BigView**,来源与改动见文末「分叉与许可」。 --- ## 截图 带关键字查询(`error|timeout`)的日志:每个关键字各有一种高亮色,`worker-7` 被标记成绿色,命中的行列在下方结果面板里。 ![BigLogView 展示日志文件、关键字分色、颜色标记与结果面板](https://gitee.com/wasdzy/biglogview/raw/master/assets/screenshot-log.png) JSON Lines,语法配色取自当前编辑器主题,关键字规则同样生效: ![BigLogView 展示带语法高亮的 JSON Lines 文件](https://gitee.com/wasdzy/biglogview/raw/master/assets/screenshot-jsonl.png) CSV,自动识别分隔符、表头与表格视图: ![BigLogView 以表格形式展示 CSV 文件](https://gitee.com/wasdzy/biglogview/raw/master/assets/screenshot-csv.png) 这三张都是 BigLogView 自身的界面截图,用的是示例数据。图片也随 VSIX 一起打包,离线安装时同样能看到。 ## 功能特性 - **不挑文件大小** — 多 GB 文件立刻打开;第一屏几十毫秒就出现,文件在后台建索引 - **内存占用低** — 只保留一份紧凑的行索引,文件本身从不读进内存;屏幕上显示多少行就读多少行 - **重开即秒开** — 索引缓存在磁盘上,文件没变就一直复用 - **全文件搜索** — 字面关键字,支持 `|`(任一)、`&`(全部)、`>`(按顺序)三种规则,默认忽略大小写,结果流式返回并带进度与结果面板 - **没有正则语法** — 你敲的是词,不是模式:`error|fail` 命中两者之一,`ANR&timeout` 要求同时出现,`start>init>ready` 要求按这个顺序出现 - **关键字规则通吃** — 同一套表达式在日志、JSON Lines、CSV、纯文本上都可用,并且同时驱动过滤、导出、结果列表与 `F3` 跳转 - **过滤** — 只显示命中的行,切换即时生效。搜索栏按钮在关闭状态写 **Only matches**,开启后写 **All lines** - **颜色标记** — 选中一段文本,右键即可把全文所有出现处涂成六种颜色之一(红、绿、蓝、橙、紫、黄),行为与作者早前的个人日志查看器一致;右键 → **Clear Marks** 一次清空;标记属于这个文件,重新打开仍在(可用 `biglogview.marks.persist` 关掉);**结果列表**里也会带标记,摘录读起来和原文一致 - **复制筛选结果** — 右键 → **Copy All Filtered Lines**,把当前筛选留下来的行按文件顺序整段复制; 上限 8 MB,状态栏会说明复制了多少行,其余的行用 **Export Filtered Lines** 导出成文件 - **复制整行** — 右键任意一行 → **Copy Line**,把这一行整段放进剪贴板;即使视图里那一行被截断,复制的也是完整内容; 结果列表里同样有这个入口,复制的是摘录背后那条原始文件行 - **关键字分色** — 多关键字查询会给每个关键字分配各自的颜色(按出现顺序取红、绿、蓝、橙、紫、黄),文件视图与结果列表同步生效,结果面板上方还有图例标明每个关键字是什么颜色;单个关键字则沿用主题自带的命中高亮 - **导出** — 把过滤后的行写成一个新文件 - **日志文件** — 按级别着色、识别时间戳,搜索栏最右侧有独立的时间范围输入框,可把任意查询收窄到某段时间;输入不可用的边界时,输入框在搜索执行前就变红,头部会写明当前生效的时间窗 - **JSON Lines** — 用你主题里 JSON 的配色做语法高亮,详情面板列出字段并格式化 JSON,支持 `level=error` 这类字段过滤 - **CSV / TSV** — 自动识别分隔符、识别表头、表格视图,列宽可拖 - **纯文本** — 用 BigLogView 打开的 `.txt` 等文本文件同样享有全文件搜索、过滤、导出与跟踪;它们默认仍归普通编辑器,BigLogView 会出现在它们的 **Reopen Editor With…** 列表里 - **跟踪尾部** — 文件增长时新行自动出现;滚到底部时视图跟随,正在生效的搜索或过滤也同步跟进 - **日志轮转** — 文件被改名、截断、删除或重建都能识别并重新建索引 - **跟随主题** — 适配任意 VS Code 配色主题 - **只读、纯本地** — 从不改动你的文件,也不向外发送任何数据 ## 性能 在 Windows 11 桌面(SSD)上用 `npm run bench -- --size 200m` 测得,样本是 200 MB、1,030,983 行的日志: | 指标 | 实测 | 预算 | | --- | --- | --- | | 首屏(索引尚未建完) | 216 ms | < 300 ms | | 完整建索引 | 350 ms | < 12 s | | 重新打开(索引来自磁盘缓存) | 37 ms | 瞬开 | | 全文件字面搜索 | 436 ms | < 6 s | | 峰值内存(RSS) | 124 MB | < 250 MB | | 跳转到指定行(p99) | 1.0 ms | < 50 ms | | 导出 97,120 行 | 1.3 s | 参考 | 耗时大致随文件大小线性增长;1 GB 与 5 GB 两个量级**没有在本机测过**,因此这里不做任何声称。剩下就看你的磁盘和 CPU。 ## 快速开始 1. **安装** — 在扩展视图里搜索 **BigLogView**(或执行 `ext install waszdy.biglogview`),也可以装打包好的 VSIX:`code --install-extension biglogview-0.4.1.vsix`,或在 **扩展 → … → 从 VSIX 安装…** 2. **打开** `.log`、`.jsonl`、`.ndjson`、`.csv`、`.tsv` 文件 — BigLogView 就是它们的默认编辑器 3. **或者** 在资源管理器里右键任意文件 → **Open File in BigLogView** 想用普通文本编辑器打开这些文件,走 **Reopen Editor With… → Text Editor**。 > `.txt` 文件默认仍由普通文本编辑器打开。某个 txt 大到编辑器吃不消时,在资源管理器里右键它 → **Open File in BigLogView**(右键菜单第一项),或者用编辑器标题栏的 **Reopen Editor With…** → **BigLogView**、**Open With…** → **BigLogView**,也可以用命令 **BigLogView: Open File in BigLogView**。用 BigLogView 打开后文件是只读的。 ## 支持的格式 | 格式 | 识别依据 | 能力 | | --- | --- | --- | | 日志 | `.log`、文件内容 | 级别着色、时间戳、时间范围过滤 | | JSON Lines | `.jsonl`、`.ndjson`、文件内容 | 语法高亮、详情面板、字段过滤 | | CSV / TSV | `.csv`、`.tsv`、文件内容(`,` 制表符 `;` `\|`) | 表格视图、表头、列宽可调 | | 纯文本 | `.txt`、`.text`、其他任意扩展名 | 搜索、过滤、导出、跟踪 | `.txt` 按定义就是纯文本:它的行不会显示成表格、也不会按日志着色,除非内容几乎全是 JSON Lines。扩展名未知的文件会嗅探(JSON Lines、日志、DSV、文本)。`.txt` 默认仍归普通文本编辑器——大到编辑不动时,用 **Reopen Editor With… → BigLogView** 或右键 **Open File in BigLogView** 打开它。 格式由扩展名和文件头几行推断。要改,用 **BigLogView: Change Format…**,或者点状态栏里的格式名;这个选择按文件记住。 ### 字段过滤(JSON Lines) | 过滤写法 | 含义 | | --- | --- | | `level=error` | 字段等于该值 | | `user.id=42` | 嵌套字段 | | `msg~timeout\|refused` | 字段匹配某个正则 | 在详情面板里点某个字段,即按它的值过滤。 ### 关键字规则(任意格式,也是唯一的搜索语法) 搜索框接收的是关键字表达式——没有正则模式,大小写默认忽略,除非你打开 **Aa**(`Alt+C`): | 语法 | 规则 | 例子 | | --- | --- | --- | | `a\|b\|c` | 任一命中(OR) | `error\|fail\|crash` | | `a&b` | 全部命中,顺序不限(AND) | `ANR&timeout` | | `a>b>c` | 同一行内按此顺序出现(ORDERED) | `start>init>ready` | 分组之间按 OR 组合:`Error|Fatal&Watchdog` 命中含 `Error` 的行,或同时含 `Fatal` 与 `Watchdog` 的行。组内 `&` 优先于 `>`,ORDERED 规则里关键字不能重叠(`a>a` 需要两个各自独立的 `a`)。单个词就是纯子串搜索,输入 `timeout` 就找出所有含 `timeout` 的行——默认忽略大小写。多个关键字会用不同颜色标注,所以 `Error|Fatal&Watchdog` 一眼能看出哪一行是哪一处命中。输入 `(` 或 `[` 是安全的:这些字符按字面匹配,永远不会被当成模式。过滤、导出、结果列表与 `F3` 跳转都作用在命中集上。 ## 命令 | 命令 | 说明 | | --- | --- | | BigLogView: Open File in BigLogView | 用 BigLogView 打开任意文件 | | BigLogView: Go to Line... | 跳转到指定行号 | | BigLogView: Find in File | 聚焦搜索栏 | | (搜索栏的 **Search** 按钮) | 等同 `Enter`:执行改动后的查询,或跳到下一处命中 | | BigLogView: Find Next / Find Previous | 在命中之间跳转 | | BigLogView: Toggle Filter (Show Only Matching Lines) | 只显示命中的行 | | BigLogView: Export Filtered Lines | 把过滤后的行另存为新文件 | | BigLogView: Change Format... | 选择日志、JSON Lines、CSV、TSV 或纯文本 | | (Open With / Reopen Editor With) | `.txt`、`.text`、`.log`、`.jsonl`、`.ndjson`、`.csv`、`.tsv` 都会出现在这里;只有带格式的那几种默认用 BigLogView 打开 | ## 设置 | 设置项 | 默认值 | 说明 | | --- | --- | --- | | `biglogview.marks.persist` | `true` | 文件关闭再打开后保留右键颜色标记。关掉:标记只在当前编辑器会话内有效 | ## 快捷键 | 操作 | Windows / Linux | macOS | | --- | --- | --- | | 搜索 | `Ctrl+F` | `Cmd+F` | | 下一处 / 上一处命中 | `F3` / `Shift+F3` | `Cmd+G` / `Shift+Cmd+G` | | 跳转到行 | `Ctrl+G` | `Ctrl+G` | | 区分大小写 | `Alt+C` | `Alt+C` | | 关闭搜索 | `Escape` | `Escape` | ## 已知限制 BigLogView 是为"读"和"搜"而造的,以下事情它**不做**: - **不排序** — 既不排行的顺序,也不排 CSV 列;对多 GB 文件排序需要一份副本 - **不编辑** — 文件是只读的 - **只支持本地文件** — 暂不支持远程、SSH 或虚拟文件系统 - **只处理 UTF-8 与 UTF-16** — 带 BOM 的 UTF-16(LE 或 BE)会在扩展存储目录里解码出一份 UTF-8 副本,后续读取都走副本,跟踪尾部照常可用;UTF-32、传统代码页等其他编码不解码,含 NUL 字节但没有 UTF-16 BOM 的文件仍按二进制处理 - **时间戳没有时区时按 UTC 处理** — 少见的时间戳布局可能不被时间范围过滤识别 - **含换行的 CSV 字段**会被拆成多行显示——BigLogView 的单位就是"行" - **搜索逐行进行** — 模式无法跨换行匹配 - **超长行**在视图里按 16 KB 截断(搜索与导出仍看整行);JSON 详情面板单行最多读 1 MB - **传统 `.tmTheme` 配色** — JSON Lines 高亮会退回默认配色 - **索引缓存**放在 VS Code 扩展存储里——总量最多 500 MB,30 天未使用的条目会被清理 ## 构建 ```bash npm install npm run build # 扩展、worker 与 webview 打包 npm run watch # 开发模式,自动重建 npm test # 单元测试 npm run test:integration # VS Code 集成测试(BIGLOGVIEW_LARGE=1 / BIGLOGVIEW_HUGE=1 会额外造 1 GB / 5 GB 文件) npm run bench # 各阶段的内存与速度 ``` 在 VS Code 里按 `F5` 启动扩展开发宿主。 ## 分叉与许可 BigLogView 是 [BigView](https://github.com/fogio-org/vscode-bigview) 的分叉项目,上游作者 fogio,同样以 MIT 许可发布。本分叉的改动包括:支持 `.txt` / `.text`(搜索、过滤、导出、跟踪,并出现在 **Reopen Editor With…** 里)、把正则界面换成移植自作者早期个人日志查看器的关键字规则语法、默认忽略大小写、UTF-16 源文件走解码副本、颜色标记、带图例的关键字分色、时间范围输入框、Search 按钮与「Only matches / All lines」切换、`biglogview.marks.persist` 设置,以及整体改名为 BigLogView。 上面提到的那个早期个人查看器是作者自己的工具,从它沿用来的语法与标记行为不涉及任何第三方署名。 上游的 MIT 声明原文一字不动地保留在 `LICENSE` 里;分叉关系、来源与改动清单写在 `NOTICE` 中。MIT 允许改名、修改、商用与再分发,前提是原始的版权声明与许可文本随代码一起分发——它们都在。 ## 许可协议 MIT,详见 `LICENSE`。 © 2026 waszdy(BigLogView:本分叉、其改动与图标)。基于 BigView,© 2026 fogio,依 MIT 许可使用;上游声明原文保留在 `LICENSE` 中,改动清单见 `NOTICE`。