Repomix

这是什么？适合谁？

Repomix 是一个将整个代码仓库打包为单个 AI 友好文件的工具。当你需要把一整个项目喂给 ChatGPT、Claude、DeepSeek 等大模型分析时，Repomix 能自动收集所有代码文件、生成目录结构、统计代码量，并输出为一个格式化的纯文本文件，让 AI 一次性理解你的全量代码。

适合人群：需要 AI 辅助理解大型代码库的开发者、进行代码审计的安全工程师、向 AI 提问”这个项目怎么改”的普通程序员。

前置条件：Node.js 18+，对命令行有基本了解。

准备工作

1. 安装：npm install -g repomix 或 npx repomix
2. 可选配置：在项目根目录创建 repomix.config.json 自定义输出格式和排除规则
3. 时间预算：安装 1 分钟，大型项目打包 10-30 秒

核心步骤

第一步：进入项目目录

cd /path/to/your/project

第二步：一键打包

repomix

运行后自动生成 repomix-output.txt（默认文件名），包含：

• 项目目录树
• 每个文件的完整内容
• 文件统计信息

第三步：喂给 AI

将 repomix-output.txt 的内容直接粘贴到 AI 对话中，或使用 --clipboard 参数自动复制到剪贴板：

repomix --clipboard

高级用法

指定输出格式：支持 xml、markdown、plain 三种格式：

repomix --style xml

排除特定文件：在配置文件中指定 .gitignore 风格的排除规则，或在命令行使用：

repomix --ignore "*.min.js,dist/,node_modules/"

自定义 token 计数：指定目标模型的 token 上限：

repomix --token-limit 100000

常见踩坑

1. 输出文件过大：大型项目可能输出几十 MB，大部分 AI 有上下文限制。解决：使用 --include 只打包关键目录，或先拆分询问。
2. node_modules 被包含：默认排除 node_modules，但若项目结构特殊可能漏掉。解决：确认配置文件中的排除规则覆盖所有构建产物。
3. 二进制文件乱码：打包图片、字体等二进制文件会输出乱码。解决：添加对应扩展名到排除列表。
4. 敏感信息泄露：.env 文件默认包含在输出中。解决：务必在配置中排除 .env* 和凭证文件。
5. 中文编码问题：某些终端环境下中文显示乱码。解决：确认终端使用 UTF-8 编码，或使用 --style markdown 输出。

FAQ

Q1：和直接把代码目录拖进 AI 对话框有什么区别？ A：多数 AI 对话界面不支持文件夹上传，即使支持也无法保持目录结构。Repomix 保留了文件路径和层级关系，AI 能理解代码组织方式。

Q2：能处理多大的项目？ A：理论上无上限，但实际受 token 限制。100K token 约对应 2000-5000 行代码（取决于注释密度）。建议分模块打包。

Q3：支持哪些编程语言？ A：所有语言，Repomix 不分析语法，只是文件收集器。语言检测仅用于统计和语法高亮元数据。

Q4：免费吗？ A：完全开源免费，MIT 许可证。可商用。

Q5：和 GitHub Copilot 的代码理解有什么区别？ A：Copilot 通过 LSP 理解代码结构，适合局部补全。Repomix 让 AI 看到全量代码，适合架构级别的分析和重构建议。

进阶学习

• Repomix + Claude Code：将 repomix-output.txt 作为 Claude Code 的上下文注入，实现全项目级别的代码审查和重构
• Repomix + DeepSeek V4：利用 DeepSeek 的 1M 上下文窗口，打包整个中型项目（2-5 万行）进行一次性分析
• CI/CD 集成：在 GitHub Actions 中将 Repomix 输出作为构建产物，发送给 AI 进行自动化代码审查
• 多项目对比：打包两个相似项目，让 AI 对比架构差异和实现质量

参考链接

• 官方仓库
• 官方文档
• npm 包

本文基于公开资料整理，AI 辅助生成，数据核验日期 2026-08-06。独立实测和深度评测请参考评分文件。