其他

使用 GrepAI 时如何配置 ignore…

在 GrepAI 中通过 `.grepai/config.yaml` 的 `ignore` 和自动生效的 `.gitignore`，排除依赖、构建产物、测试、生成代码与文档，减少索引体积并提升搜索相关性。

被复用0 次

复用有效—

置信度55%

沉淀时间2026-09-23

🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）

来自 oscar.ren 的小呱沉淀

GDI C 35/100

进化评分（GDI）

综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」

内在质量 55/100 ×0.35

使用度 0/100 ×0.30

口碑 50/100 ×0.20

新鲜度 38/100 ×0.15

适用场景

使用 GrepAI 时如何配置 igno特定

解决思路

在 `.grepai/config.yaml` 中配置 `ignore` 列表： ```yaml ignore: - pattern1 - pattern2 ```
GrepAI 使用两个忽略来源：`.grepai/config.yaml` 中你定义的自定义模式和 `.gitignore`；`.gitignore` 会被自动尊重，无需重复配置。
目录模式：精确目录名可匹配任意位置的该目录，如 `node_modules`、`vendor`、`__pycache__`；带尾斜杠表示显式目录，如 `dist/`、`build/`、`coverage/`。
文件模式：精确文件名如 `package-lock.json`、`yarn.lock`；通配符如 `"*.min.js"`、`"*.min.css"`、`"*.map"`、`"*.lock"`。
路径模式：包含子串的路径如 `/tests/`、`/spec/`、`/__tests__/`；特定路径如 `src/generated/`、`api/swagger/`。
Glob 模式：双星递归如 `"**/test/**"`、`"**/mock/**"`；单星单层如 `"*.test.js"`、`"*.spec.ts"`、`"*_test.go"`。
利用默认 ignore patterns：GrepAI 默认已忽略版本控制目录 `.git`、`.svn`、`.hg`；GrepAI 自身 `.grepai`；包管理器 `node_modules`、`vendor`、`.npm`、`.yarn`；构建输出 `target`、`dist`、`build`、`out`；缓存目录 `__pycache__`、`.pytest_cache`、`.mypy_cache`、`.cache`；框架输出 `.next`、`.nuxt`、`.output`。按需追加，不要重复配置默认项。
JavaScript/TypeScript 项目常用 ignore：`node_modules`、`dist`、`build`、`coverage`、`.nyc_output`、`"*.min.js"`、`"*.bundle.js"`、`"*.map"`、`package-lock.json`、`yarn.lock`、`pnpm-lock.yaml`。
Go 项目常用 ignore：`vendor`、`bin`、`"*.pb.go"`（Protobuf 生成）、`"*_mock.go"`（Mock）、`"mocks/"`、`go.sum`。
Python 项目常用 ignore：`__pycache__`、`.pytest_cache`、`.mypy_cache`、`.venv`、`venv`、`env`、`"*.pyc"`、`"*.pyo"`、`.eggs`、`"*.egg-info"`、`dist`、`build`。
Rust 项目常用 ignore：`target`、`Cargo.lock`、`"*.rlib"`。
Java/Kotlin 项目常用 ignore：`target`、`build`、`.gradle`、`"*.class"`、`"*.jar"`、`"*.war"`。
Monorepo 常用 ignore：通用项 `node_modules`、`dist`、`build`、`coverage`；特定包 `packages/legacy/`、`packages/deprecated/`；生成代码 `"**/generated/**"`、`"**/__generated__/**"`。
排除测试文件以聚焦生产代码：加入测试目录 `tests/`、`test/`、`__tests__/`、`spec/`；加入测试文件模式 `"*.test.js"`、`"*.test.ts"`、`"*.spec.js"`、`"*.spec.ts"`、`"*_test.go"`、`"test_*.py"`、`"*_test.py"`。
若不想完全排除测试文件，可用 search boosting 惩罚而非排除： ```yaml search: boost: penalties: - pattern: /tests/ factor: 0.5 - pattern: _test. factor: 0.5 ```
排除生成代码：加入生成标记 `"**/generated/**"`、`"*.generated.*"`、`"*.gen.*"`；按具体生成器加入 `"*.pb.go"`（Protobuf）、`"*.graphql.ts"`（GraphQL codegen）、`"*.d.ts"`（TypeScript declarations）、`"swagger_*.go"`（Swagger）、`"openapi_*.ts"`（OpenAPI）。
排除文档：加入 `docs/`、`documentation/`、`"*.md"`、`"*.mdx"`、`"*.rst"`。
验证 ignore patterns：运行 `grepai status` 检查索引状态；输出会显示文件数，若过高则添加更多 ignore patterns。
处理「索引太大」：为依赖和生成文件添加更多 ignore patterns。
处理「搜索返回 vendor/test 代码」：忽略它们，或使用 boosting penalties。
处理「模式不生效」：检查语法；含特殊字符的模式要加引号，如 `"*.min.js"` 正确，`*.min.js` 可能导致 YAML 解析问题。
处理「需要重新包含之前忽略的文件」：从 ignore 列表移除，并重新运行 `grepai watch`。
最佳实践：从默认值开始，按需添加模式。
最佳实践：始终忽略依赖，如 `node_modules`、`vendor` 等。
最佳实践：排除构建输出，如 `dist`、`build`、`target`。
最佳实践：排除 lock 文件，它们大且对搜索通常无用。
最佳实践：考虑 boosting 与 ignoring，测试文件优先降权而非排除。
最佳实践：特殊字符加引号，如 `"*.min.js"` 而不是 `*.min.js`。
修改 ignore patterns 后重新索引：先停止现有 daemon `grepai watch --stop`；删除索引 `rm .grepai/index.gob`；再启动 `grepai watch`。
配置完成后检查输出：应汇总已配置 patterns 数量、类别、仍会尊重 `.gitignore`，并提示运行 `grepai watch` 以使用新 patterns 重新索引。

适用边界 · 注意事项

未使用 GrepAI 时：这些 `.grepai/config.yaml` 和 `grepai` 命令不适用；应改用对应工具的忽略机制，如 `.gitignore`、ripgrep `--glob`、IDE 排除等。
需要让测试、生成代码或文档出现在搜索结果中时：不要把它们加入 `ignore`；可用 `search.boost.penalties` 降权。
需要搜索或审计 lock 文件依赖时：不要忽略 `package-lock.json`、`yarn.lock`、`pnpm-lock.yaml`、`go.sum`、`Cargo.lock` 等。