Terminal Logger
English | VS Code Marketplace
一个 VSCode 扩展，利用 Shell Integration API（VSCode 1.93+）自动记录 IDE 终端的命令及输出到日志文件，无需创建特殊终端。
功能特性
- 自动记录终端输出 — 所有 IDE 终端中执行的命令及输出自动记录到日志文件
- 时间戳支持 — 每行日志自动添加时间戳
[2026-02-12 10:30:45]
- 多终端支持 — 每个终端独立记录，日志文件自动命名
- 状态栏显示 — 实时显示记录状态和终端数量
- 可配置路径 — 自定义日志保存位置
前提条件
- VSCode 1.93.0 或更高版本
- 终端 Shell Integration 已启用（默认已启用）
安装
从 VSIX 文件安装
code --install-extension terminal-logger-1.0.1.vsix
从源码构建
npm install
npm run compile
npx vsce package
使用方法
- 安装扩展后，日志记录自动对所有终端生效。
- 在 VSCode 中打开任意终端，正常执行命令即可。
- 使用命令面板 (
Cmd+Shift+P) 执行 Terminal Logger: 打开日志文件夹 查看日志文件。
命令
| 命令 |
说明 |
Terminal Logger: 开启/关闭日志记录 |
切换日志记录状态 |
Terminal Logger: 打开日志文件夹 |
在系统文件管理器中打开日志目录 |
Terminal Logger: 清空当前日志 |
清空指定日志文件 |
配置选项
| 配置项 |
默认值 |
说明 |
terminalLogger.enabled |
true |
是否启用终端日志记录 |
terminalLogger.logPath |
"" |
日志文件保存路径（留空使用工作区 .terminal-logs 目录） |
terminalLogger.timestampFormat |
"[YYYY-MM-DD HH:mm:ss]" |
时间戳格式 |
terminalLogger.fileNamePattern |
"terminal_{terminalName}_{date}.log" |
日志文件名模式 |
terminalLogger.includeInput |
true |
是否记录用户输入命令 |
日志示例
============================================================
[2026-02-12 10:30:45] 终端日志会话开始
============================================================
--- [2026-02-12 10:30:47] 命令: npm install ---
added 125 packages in 3s
--- [2026-02-12 10:30:52] 命令: npm run compile ---
Compilation complete.
工作原理
本扩展使用 VSCode 的 Shell Integration API（onDidStartTerminalShellExecution / onDidEndTerminalShellExecution）监听所有 IDE 终端中的命令执行。当命令运行时：
- 通过
execution.commandLine.value 捕获命令文本
- 通过
execution.read() 流式读取命令输出
- 清除 ANSI 转义码后，带时间戳写入日志文件
License
MIT
| |
