Repomix 注释移除removeComments完全指南在打包输出中自动剥离代码注释、降低 Token 消耗【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix在将整个代码仓库打包为单一 AI 友好文件如repomix-output.md或.xml喂给 LLM 时代码中的注释往往占据大量不必要的 token却几乎不提供结构信息。Repomix 内置的**注释移除Comment Removal**功能可以在生成输出文件时自动剥离代码注释让 LLM 聚焦于真正的逻辑实现同时显著缩小输出体积。本文基于 comment-removal.md中文版对应 comment-removal.md展开结合 Repomix 源码级实现fileManipulate.ts、fileProcess.ts、configSchema.ts完整讲解配置方法、命令行用法、支持的语言范围、处理管线顺序与底层原理读完即可在真实项目中直接落地。功能概述为什么需要移除注释Repomix 把整个仓库压缩进一个文件时注释的存在会带来两个问题Token 浪费单行注释、块注释、文档注释在喂给 LLM 时同样消耗上下文窗口但对理解代码行为帮助有限噪音干扰大量注释会稀释 LLM 对代码结构函数、类、调用关系的关注。注释移除功能在输出文件生成阶段自动执行将代码库中的注释从内容里剥离原始源文件不会被修改仅影响 Repomix 生成的打包输出。该功能与 代码压缩基于 Tree-sitter 提取类、函数等结构可以组合使用进一步压缩 token 数量。使用方法配置文件与命令行两种开启方式方式一配置文件推荐持久化在项目根目录的repomix.config.json中将output.removeComments设为true{ output: { removeComments: true } }对应的配置项在 configSchema.ts 中通过 valibot 定义为可选布尔值其默认值为false见 configSchema.ts即不开启时注释原样保留。你也可以在配置文件中同时组合其他输出处理项例如{ output: { removeComments: true, removeEmptyLines: true, showLineNumbers: true } }方式二命令行参数适合一次性打包无需修改配置文件直接在执行打包时追加--remove-comments标志repomix --remove-comments该参数在 cliRun.ts 中定义同时提供了两个等价别名见 cliRun.tsrepomix --strip-comments repomix --no-comments命令行选项最终由 defaultAction.ts 合并进输出配置优先级覆盖配置文件中的同名设置只有显式传入时才会覆盖未传入则沿用配置文件值。注意命令行选项与配置文件对diff 输出同样生效——测试 defaultAction.test.ts 中即验证了 diff 模式下注释也被移除因此git diff场景同样能受益。支持的编程语言与文件类型Repomix 的注释移除覆盖面非常广。从源码 fileManipulate.ts 看其通过文件扩展名映射到StripCommentsManipulator每个映射指定了对应的语言标识传给repomix/strip-comments库完整清单如下扩展名语言注释风格示例.js.jsx.mjs.cjs.mjsx.ts.tsx.mts.cts.mtsxJavaScript/TypeScript//、/* */.pyPython#、、.javaJava//、/* */.c.hC//、/* */.cpp.hpp.cc.cxxC//、/* */.htmlHTML!-- --.xmlXML!-- --.cssCSS/* */.lessLess//、/* */.scss.sassSass//、/* */.goGo//、/* */.rsRust//、/* */.rbRuby#.phpPHP//、#、/* */.swiftSwift//、/* */.ktKotlin//、/* */.dartDart//、/* */.csC#//、/* */.solSolidity//、/* */.sqlSQL--、/* */.shShell#.yaml.ymlYAML#.vueVueHTML CSS JS 组合三种风格同时处理.svelteSvelteHTML CSS JS 组合三种风格同时处理关键细节组合文件.vue与.svelte单文件组件通过CompositeManipulator依次应用 HTML、CSS、JavaScript 三种剥离器fileManipulate.ts因此模板注释、样式注释和脚本注释都会被移除大小写不敏感扩展名匹配会先转成小写fileManipulate.ts因此Main.JS、style.CSS这类大写扩展名文件也能被正确处理未覆盖的语言若文件扩展名不在映射表内getFileManipulator返回null该文件内容原样保留、不做处理见 fileProcessContent.ts绝不会误删内容。实际效果示例文档给出了最直观的 JavaScript 示例。输入// This is a single-line comment function test() { /* This is a multi-line comment */ return true; }开启注释移除后输出function test() { return true; }从实现层面看这一过程由StripCommentsManipulator.removeComments完成fileManipulate.ts核心是调用repomix/strip-comments库并传入两个关键参数language上表对应的语言标识preserveNewlines: true保留被删除注释占用的换行避免行结构塌陷同时通过rtrimLines剔除每行行尾空白。这意味着代码的行间距大致保持之后若再叠加removeEmptyLines清理空行输出会非常整洁。处理管线顺序与 worker 线程调度源码级原理注释移除并不是独立执行的它嵌入在 Repomix 文件处理的两阶段管线中。从 fileProcess.ts 的注释和 fileProcess.ts 的实现可以清晰看到完整变换顺序removeComments → compressworker 线程阶段 → truncateBase64 → removeEmptyLines → trim → showLineNumbers主线程阶段三个关键设计点注释移除先于行号添加这正是文档注释移除在行号添加等其他步骤之前执行一说的依据。只有先剥离注释后续showLineNumbers生成的行号才能对应干净的代码空行清理紧随其后removeEmptyLines特意放在removeComments之后执行这样注释删除后留下的空行会被立即清理fileProcess.ts测试 fileProcess.test.ts 专门验证了这一行为worker 线程调度注释剥离属于 CPU 密集型 AST 操作与 Tree-sitter 压缩一样会被调度到 worker 线程池并行执行fileProcess.ts。只要output.removeComments为true或存在需要压缩的文件processFiles就会启用worker_threads运行时fileProcess.ts大仓库打包时不会阻塞主线程。与代码压缩compress的区别与组合注释移除与文档中关联的 代码压缩 是两个独立但互补的功能removeComments只删除注释保留原始代码行可读性好、token 节省中等compress基于 Tree-sitter 解析仅提取类、函数、接口等代码结构骨架token 节省最大但会丢失函数体内的实现细节。两者都发生在 worker 阶段可以同时开启。测试 fileProcess.test.ts 中明确记录了[removeComments → compress] (worker)的组合顺序先剥离注释再提取结构压缩产物自然不会携带注释。另一个联动细节当文件被压缩时showLineNumbers会自动对该文件关闭fileProcess.ts因为压缩内容是重构后的签名而非按行对应的原始源码。注意事项与边界行为文档注释可能被保留官方文档指出JSDoc 等某些注释会根据语言与上下文被保留见 comment-removal.md。注释剥离是尽力而为的语法层操作不会影响字符串字面量中的内容例如字符串里出现的//不会被误删输出头部会标注处理信息开启后生成的输出文件头部会通过analyzeContent记录commentsRemoved: trueoutputStyleDecorate.ts方便你确认本次输出确实应用了注释移除不修改源文件所有变换只作用于内存中的内容副本仓库文件保持原样不支持的语言自动跳过未映射扩展名的文件内容不会被触碰也不会导致打包失败。相关资源代码压缩 — 通过提取代码结构进一步降低 token 数量配置指南 — 在配置文件中完整设置output下的各项处理选项命令行选项 —--remove-comments及更多输出相关参数说明【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考