大日志文件查看器

一个专业的VSCode扩展，用于快速查看和处理大型日志文件（支持几十MB甚至GB级别的文件）。提供强大的搜索、过滤、分析、标注等功能，让日志查看和问题排查变得简单高效。

✨ 核心功能

🚀 高性能加载

• 秒开大文件 - 使用虚拟滚动技术，即使GB级别的日志文件也能秒开
• 智能分页 - 支持自定义每页显示行数（50-1000行）
• 懒加载 - 滚动时动态加载内容，内存占用低

🔍 强大的搜索功能

• 关键词搜索 - 实时搜索日志内容，高亮显示匹配结果
• 正则表达式 - 支持正则模式，满足复杂搜索需求
• 反向搜索 - 支持反向匹配（排除包含关键词的日志）
• 高级搜索 - 多条件组合搜索（AND/OR逻辑）
• 智能高亮 - 自动高亮时间戳、日志级别等关键信息

🎯 智能过滤

• 日志级别过滤 - 按ERROR、WARN、INFO、DEBUG等级别过滤
• 时间范围过滤 - 按时间段筛选日志
• 折叠重复日志 - 自动识别并折叠连续重复的日志行，支持时间戳忽略
• 全选功能 - 一键全选/取消所有过滤条件

📊 数据分析

• 统计信息 - 查看总行数、各级别日志数量、时间范围等统计数据
• 时间线导航 - 可视化时间分布图，快速跳转到指定时间段
• 日志导出 - 导出过滤后的日志到新文件

🗑️ 日志管理

• 按时间删除 - 删除指定时间之前/之后的日志
• 按行数删除 - 删除指定行之前/之后的日志
• 安全提示 - 删除前提供警告，避免误操作

📝 标注功能

• 书签管理 - 为重要日志行添加书签，快速定位
• 注释功能 - 为日志行添加自定义注释，便于协作分析
• 快速跳转 - 支持跳转到指定行号

🎨 可视化增强

• 语法高亮 - JSON/XML结构化数据自动格式化显示
• 颜色标记 - 不同级别日志使用不同颜色，一目了然
• 颜色图例 - 提供颜色说明，便于理解
• 暗色主题 - 完美适配VSCode暗色主题

🎯 支持的时间格式

自动识别多种常见日志时间格式：

• 2024-01-01 12:00:00 / 2024-01-01 12:00:00.123
• 2024/01/01 12:00:00 / 2024/01/01 12:00:00.123
• [2024-01-01 12:00:00] / [2024-01-01 12:00:00.123]
• 01-01-2024 12:00:00
• 2024-01-01T12:00:00 / 2024-01-01T12:00:00.123Z (ISO 8601)

📖 使用方法

打开日志文件

有三种方式打开日志文件：

1. 右键菜单 - 在文件资源管理器中，右键点击 .log 或 .txt 文件，选择「打开大日志文件」
2. 命令面板 - 按 Ctrl+Shift+P (Mac: Cmd+Shift+P)，输入「打开大日志文件」
3. 编辑器标题栏 - 打开日志文件后，点击编辑器右上角的图标

🔍 搜索日志

基础搜索：

1. 在搜索框中输入关键词
2. 勾选「正则」启用正则表达式模式（可选）
3. 勾选「反向搜索」排除包含关键词的日志（可选）
4. 点击「🔍 搜索」或按回车

高级搜索：

1. 点击「🔍 高级搜索」按钮
2. 添加多个搜索条件
3. 选择逻辑关系（AND/OR）
4. 执行组合搜索

🎯 过滤日志

按日志级别过滤：

• 在过滤面板中勾选/取消勾选 ERROR、WARN、INFO、DEBUG 等级别
• 使用「✔️ 全选」快速切换所有级别

折叠重复日志：

• 勾选「📎 折叠重复日志」自动合并连续重复的日志
• 折叠时会忽略时间戳的差异，只比较日志内容
• 点击折叠组可以展开查看详细内容

时间范围过滤：

• 使用高级搜索功能，设置开始时间和结束时间

📊 查看统计信息

1. 点击「📈 统计」按钮
2. 查看总行数、各级别日志数量、时间范围等信息
3. 了解日志文件的整体情况

📝 添加书签和注释

书签功能：

1. 点击「📌 书签」按钮
2. 添加/管理书签
3. 快速跳转到重要日志行

注释功能：

1. 点击「📝 注释」按钮
2. 为日志行添加说明性注释
3. 方便团队协作分析问题

🎯 快速定位

1. 点击「🎯 定位」按钮
2. 输入行号
3. 快速跳转到指定位置

💾 导出日志

1. 使用过滤/搜索功能筛选需要的日志
2. 点击「💾 导出」按钮
3. 导出过滤后的结果到新文件

🗑️ 删除日志

1. 点击「🗑️ 删除」按钮
2. 选择删除方式：
   • 按时间删除 - 删除指定时间之前/之后的日志
   • 按行数删除 - 删除指定行之前/之后的日志
3. 输入时间或行号
4. 确认操作

⚠️ 重要提示：删除操作会直接修改原文件且不可恢复，请务必先备份重要日志！

🛠️ 开发调试

环境要求

• Node.js >= 18.0.0
• VSCode >= 1.75.0
• TypeScript >= 5.0.0

安装依赖

npm install

编译项目

npm run compile

开发模式（自动编译）

npm run watch

调试扩展

1. 在VSCode中打开项目
2. 按 F5 启动扩展开发主机
3. 在新窗口中测试扩展功能
4. 修改代码后会自动重新编译（需要手动重新加载窗口）

打包发布

# 安装打包工具
npm install -g @vscode/vsce

# 打包扩展
vsce package

# 发布到市场（需要先注册发布者账号）
vsce publish

📁 项目结构

large_log_check/
├── src/
│   ├── extension.ts          # 扩展主入口，注册命令和事件
│   ├── logViewerPanel.ts     # WebView面板管理，UI交互逻辑
│   ├── logProcessor.ts       # 日志处理核心逻辑（读取、搜索、删除）
│   └── webview.html          # WebView界面（HTML + CSS + JavaScript）
├── out/                       # TypeScript编译输出目录
├── package.json              # 项目配置和依赖
├── tsconfig.json             # TypeScript编译配置
├── .vscodeignore             # 打包时忽略的文件
└── README.md                 # 使用说明文档

🔧 技术实现

前端技术

• 虚拟滚动 - 只渲染可见区域的日志行，大幅提升渲染性能
• 分页加载 - 支持自定义每页行数，智能加载和缓存
• 异步计算 - 折叠模式下后台异步计算总页数，不阻塞UI
• 正则匹配 - 灵活的时间戳识别和内容搜索
• DOM优化 - 高效的DOM更新策略，减少重绘重排

后端技术

• 流式读取 - 使用Node.js的readline模块，按行读取文件，避免内存溢出
• VSCode Extension API - 充分利用VSCode的扩展能力
• TypeScript - 类型安全的开发体验
• WebView通信 - 前后端消息传递机制

核心算法

• 重复日志检测 - 支持1-10行长度的重复模式识别
• 时间戳去除 - 智能识别并去除5种常见时间戳格式
• 智能高亮 - 自动识别并高亮JSON/XML等结构化数据
• 增量搜索 - 流式搜索，支持大文件快速检索

⚡ 性能表现

• ✅ GB级别日志文件秒开（不受文件大小限制）
• ✅ 支持千万行级别的日志文件
• ✅ 分页切换响应 < 100ms
• ✅ 搜索响应时间 < 3秒（取决于文件大小和搜索条件）
• ✅ 滚动流畅，无卡顿
• ✅ 内存占用低（仅加载当前页数据）
• ✅ 折叠模式异步计算，不阻塞UI

⚠️ 注意事项

1. 数据安全 - 删除操作会直接修改原文件且不可恢复，请务必先备份重要日志
2. 时间格式 - 如果日志没有标准时间戳，按时间删除和时间线功能可能无法正常工作
3. 搜索性能 - 搜索功能需要扫描整个文件，超大文件（>1GB）可能需要较长时间
4. 折叠功能 - 折叠重复日志时会异步计算总页数，首次计算可能需要一些时间
5. 浏览器兼容 - 使用VSCode内置浏览器引擎，确保VSCode版本 >= 1.75.0

🎯 已完成功能

• ✅ 虚拟滚动和分页加载
• ✅ 多种时间格式识别
• ✅ 日志级别过滤（ERROR, WARN, INFO, DEBUG）
• ✅ 正则表达式搜索
• ✅ 高级组合搜索
• ✅ 反向搜索
• ✅ 书签和注释功能
• ✅ 日志导出
• ✅ 折叠重复日志
• ✅ 时间线可视化
• ✅ 统计分析
• ✅ JSON/XML语法高亮
• ✅ 暗色主题适配

🚧 后续优化计划

• [ ] 支持更多日志格式（Log4j、Syslog等）
• [ ] 性能优化：索引文件，加速搜索
• [ ] 支持日志对比（Diff）
• [ ] 支持日志合并
• [ ] 添加性能分析工具（找出慢查询、频繁错误等）
• [ ] 支持自定义配色方案
• [ ] 支持日志模板识别
• [ ] 添加AI辅助分析功能

🤝 贡献

欢迎提交Issue和Pull Request！

如果这个项目对你有帮助，请给个Star ⭐️

📄 License

MIT License

👨‍💻 作者

@wake

🔗 相关链接

• GitHub仓库
• VSCode市场
• 问题反馈

享受高效的日志查看体验！ 🎉