Repomix快速入门指南：5分钟掌握代码打包技巧

左松钦Travis

1032人浏览 · 2026-03-26 07:13:05

左松钦Travis · 2026-03-26 07:13:05 发布

Repomix快速入门指南：5分钟掌握代码打包技巧

【免费下载链接】repomix 📦 Repomix (formerly Repopack) 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正是你需要的终极工具！这个强大的代码打包器能帮你将复杂的项目结构转换为AI友好的格式，让Claude、ChatGPT、DeepSeek等大型语言模型更好地理解你的代码。无论你是开发者、技术作者还是AI研究者，掌握Repomix都能大幅提升工作效率。

为什么选择Repomix？

在AI时代，代码分析变得前所未有的重要。但大多数AI工具有文件大小限制，难以处理复杂的项目结构。Repomix解决了这个痛点，它能：

智能打包：将整个代码库整合到单个文件中
格式优化：支持XML、Markdown、Plain等多种AI友好格式
灵活配置：使用glob模式精确控制包含/排除的文件
远程支持：直接处理GitHub仓库，无需本地克隆

Repomix的核心操作界面，左侧是GitHub Actions风格的"Repomix"按钮，右侧是功能配置面板

快速安装方法

方法一：无需安装（最快捷）

使用npx直接运行，无需任何安装步骤：

npx repomix@latest

方法二：全局安装（推荐）

选择你喜欢的包管理器：

# npm
npm install -g repomix

# yarn  
yarn global add repomix

# pnpm
pnpm add -g repomix

# bun
bun add -g repomix

# Homebrew
brew install repomix

方法三：Docker方式

适合容器化环境：

# 打包当前目录
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix

# 打包远程仓库
docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote yamadashy/repomix

安装完成后，验证是否成功：

repomix --version
repomix --help

基础使用技巧

一键打包整个项目

最简单的使用方式，在当前项目目录下运行：

repomix

这会将当前目录所有文件打包成repomix-output.md文件。

指定目录打包

如果你只想打包特定目录：

repomix src/
repomix path/to/directory

精确文件控制

使用glob模式精确选择文件：

# 只包含TypeScript和Markdown文件
repomix --include "src/**/*.ts,**/*.md"

# 排除日志文件和临时目录
repomix --ignore "**/*.log,tmp/"

处理大文件拆分

当代码库超过AI工具的文件限制时（如Google AI Studio的1MB限制），自动拆分：

repomix --split-output 1mb

这会生成多个文件：repomix-output.1.xml、repomix-output.2.xml等。

高级功能实战

远程仓库处理

无需克隆，直接处理GitHub仓库：

# 完整URL方式
repomix --remote https://github.com/user/repo

# 简写方式
repomix --remote user/repo

# 指定分支或提交
repomix --remote user/repo --remote-branch main

Git信息集成

为AI提供开发上下文：

# 包含未提交的更改
repomix --include-diffs

# 包含最近的提交历史
repomix --include-logs

# 指定提交数量
repomix --include-logs --include-logs-count 10

代码压缩优化

减少token使用，节省AI处理成本：

repomix --compress

实际应用场景

场景一：AI代码审查

将代码打包后交给AI进行审查，获得专业的重构建议：

Repomix生成的代码包成为AI审查的基础，左侧是打包输出的TXT文件，右侧是AI提供的代码审查建议

场景二：自动化测试生成

针对特定文件请求AI生成测试用例：

用户要求为fileHandler.ts添加测试，AI不仅提供重构建议，还生成了完整的测试文件

场景三：技术文档编写

将代码库打包后，让AI帮助编写技术文档、API说明或项目README。

配置文件使用

创建repomix.config.json文件进行持久化配置：

{
  "include": ["src/**/*.ts", "**/*.md"],
  "ignore": ["node_modules/**", "dist/**"],
  "output": {
    "format": "markdown",
    "split": "1mb"
  }
}

配置文件位置：src/config/configSchema.ts

实用技巧与最佳实践

技巧1：管道输入灵活性

使用标准输入传递文件列表，实现最灵活的文件选择：

# 使用find命令
find src -name "*.ts" -type f | repomix --stdin

# 使用git获取跟踪文件
git ls-files "*.ts" | repomix --stdin

# 使用ripgrep查找特定内容
rg -l "TODO|FIXME" --type ts | repomix --stdin