Logloom

Weave useful logs into your code.

Logloom 是一款面向 Visual Studio Code 的日志辅助扩展。选中变量或表达式，即可生成带上下文的 console.log；调试结束后，还能安全地注释、恢复或删除由 Logloom 创建的日志。

它不会替代调试器，而是让 JavaScript、TypeScript 和 Vue 开发中最常见的临时日志调试更快速、更整洁。

主要功能

• 选中变量或表达式，一条命令插入日志；
• 自动显示表达式名称和值，并识别所在函数；
• 可选显示 Workspace Folder 相对路径和日志行号；
• 批量注释、恢复或删除当前文件中的 Logloom 日志；
• 使用 Pro 功能管理当前项目中的 Logloom 日志；
• 支持 JavaScript、TypeScript、JSX、TSX 和 Vue 单文件组件内联脚本；
• 核心代码分析和编辑均在本地完成，不上传源代码或日志内容。

快速开始

1. 打开受支持的源代码文件；
2. 选中变量或表达式，或者把光标放在标识符上；
3. 从命令面板运行 Logloom: 插入日志，或使用快捷键：
   • macOS：Cmd+Option+L
   • Windows / Linux：Ctrl+Alt+L

有选区时，也可以从编辑器右键菜单运行 Logloom: 插入日志。

例如，在 getUser 函数中选中 user，Logloom 会生成：

console.log('[Logloom] getUser · user:', user); // @logloom:v1

选中成员属性时，Logloom 会尽量保留完整访问路径。例如，在 user.name.trim() 中选中 name，生成的日志会记录 user.name，而不是可能不在作用域中的裸变量 name。

对于多行函数中的参数，日志会插入到函数体内：

function total(subtotal, tax) {
  console.log('[Logloom] total · subtotal:', subtotal); // @logloom:v1
  const value = subtotal + tax;
  return value;
}

管理日志

Logloom 通过结尾的所有权标识 // @logloom:v1 区分插件生成的日志与手写日志。只有同时具备受支持的 console 调用结构和有效所有权标识的日志才会被管理。

console.log('handwritten', user);
console.warn('temporary', user); // @logloom:v1

运行 Logloom: 注释当前文件中的日志 后：

console.log('handwritten', user);
// console.warn('temporary', user); // @logloom:v1

手写日志、未知标识版本和结构损坏的标记都会保留。注释、恢复和删除命令支持重复执行；没有新目标时不会继续修改文件。一次批量编辑可以通过一次 Undo 撤销，成功编辑的已保存文件会自动保存。

Free 与 Pro

首版开放 Free 功能和 10 天 Pro 试用。可从命令面板运行 Logloom: 开始 10 天 Pro 试用；正式付费授权和 License Key 激活将在后续版本开放。

扩展只在 VS Code SecretStorage 中保存随机安装标识和由 Logloom 授权服务签发的试用凭证。

命令

• Logloom: 插入日志
• Logloom: 注释当前文件中的日志
• Logloom: 恢复当前文件中的日志
• Logloom: 删除当前文件中的日志
• Logloom: 注释项目中的日志（Pro）
• Logloom: 恢复项目中的日志（Pro）
• Logloom: 删除项目中的日志（Pro）
• Logloom: 开始 10 天 Pro 试用

项目级操作执行前会显示确认提示，并仅处理当前活动文件所属的 Workspace Folder。

设置

文件移动或代码增删后，已有日志中的路径和行号不会自动刷新。

支持范围

• 支持 JavaScript、TypeScript、JSX 和 TSX；
• 支持 Vue 单文件组件中的内联 <script> 和 <script setup>，脚本语言包括 js、jsx、ts 和 tsx；
• Vue 模板、样式、外链 src 及其他预处理语言不会参与插入或日志管理；
• JSX/TSX 支持简单插入，不改写 JSX 标签结构；
• 不自动为无大括号控制流、紧凑的单行函数体或箭头函数表达式体添加大括号；
• 非空选区按原文本生成日志，不判断表达式是否具有副作用；选择函数调用等表达式可能导致它再次执行；
• 不支持的语言、不安全的日志结构及无法识别的目标会被跳过并显示提示。

支持与联系

如有使用问题、功能建议，或希望了解 Logloom Pro 的后续开放计划，请发送邮件至：qiankalu@qq.com。

隐私与许可

Logloom 的代码分析、日志生成和文件编辑均在本地完成，不上传源代码或日志内容。

Logloom 是专有软件，Free 与 Pro 版本均按照最终用户许可协议授权。个人信息处理方式参见隐私说明，所含开源组件及其许可参见第三方许可证声明。

版本变更参见 CHANGELOG.md。