Dagger DirectorySearchOpts 完全指南在 Dagger Directory 中执行高性能内容搜索【免费下载链接】daggerAutomation engine to build, test and ship any codebase. Runs locally, in CI, or directly in the cloud项目地址: https://gitcode.com/GitHub_Trending/da/dagger导读本文系统讲解 Dagger 0.19 中Directory对象的核心搜索 API ——DirectorySearchOpts类型别名及其背后的Directory.search()方法。它让你在 Dagger 引擎管理的容器文件系统中以正则或字面量模式扫描目录内容并返回包含文件路径、行号、字节偏移与精确子匹配位置的SearchResult列表。读完本文你将掌握DirectorySearchOpts全部 10 个字段的语义与默认值、底层 ripgrep 的映射原理、与FileSearchOpts的关系并能直接写出可运行的 TypeScript/Go 搜索代码。DirectorySearchOpts 是什么在 Dagger 的 TypeScript SDK 中DirectorySearchOpts是一个用于配置Directory.search()调用的类型别名本质是一个对象类型。其官方定义位于 docs/versioned_docs/version-0.19/reference/typescript/api/client.gen/type-aliases/DirectorySearchOpts.md完整类型声明如下export type DirectorySearchOpts { /** * Directory or file paths to search */ paths?: string[] /** * Glob patterns to match (e.g., *.md) */ globs?: string[] /** * The text to match. */ pattern: string /** * Interpret the pattern as a literal string instead of a regular expression. */ literal?: boolean /** * Enable searching across multiple lines. */ multiline?: boolean /** * Allow the . pattern to match newlines in multiline mode. */ dotall?: boolean /** * Enable case-insensitive matching. */ insensitive?: boolean /** * Honor .gitignore, .ignore, and .rgignore files. */ skipIgnored?: boolean /** * Skip hidden files (files starting with .). */ skipHidden?: boolean /** * Only return matching files, not lines and content */ filesOnly?: boolean /** * Limit the number of results to return */ limit?: number }该定义与 SDK 源码中的生成类型 sdk/typescript/src/api/client.gen.ts 完全一致。它由 Dagger 的 codegen 工具根据 GraphQL 内省结果自动生成因此字段名与语义必须与后端 Go 实现严格同步——这正是DirectorySearchOpts能跨 TypeScript、Go、Python 等 SDK 保持一致行为的根本原因。值得注意的是pattern是唯一必填字段其余字段全部可选。这意味着最小调用只需一个搜索词dir.search({ pattern: TODO })。核心概念Directory.search 搜索从何而来类型别名背后的真正 APIDirectorySearchOpts不是孤立存在的它是Directory.search()方法的参数类型。在 TypeScript SDK 中该方法定义于 sdk/typescript/src/api/client.gen.ts签名与文档注释如下/** * Searches for content matching the given regular expression or literal string. * * Uses Rust regex syntax; escape literal ., [, ], {, }, | with backslashes. * param opts.paths Directory or file paths to search * param opts.globs Glob patterns to match (e.g., *.md) * ... */ search async (opts?: DirectorySearchOpts): PromiseSearchResult[]它返回SearchResult[]每个结果包含 5 个字段见 core/search.go字段类型含义filePathstring命中的文件路径lineNumbernumber命中的首行行号从 1 开始absoluteOffsetnumber该行在文件内的字节偏移量matchedLinesstring命中的行内容submatchesSearchSubmatch[]子匹配的位置与内容text、start、end搜索是在 Dagger 引擎内执行的Directory.search不是客户端本地搜索而是由 Dagger 引擎在容器化的目录快照上执行。整条调用链为TypeScript/Go 客户端通过 GraphQL 发出search查询参数由DirectorySearchOpts序列化GraphQL schema 层在 core/schema/directory.go 注册search节点函数并组合了core.SearchOpts的全部参数与额外的paths、globsschema 处理器调用核心实现Directory.Search()core/directory.go它挂载目录快照、校验路径然后启动ripgreprg二进制进程执行实际搜索输出结果被解析为SearchResult对象返回。从源码结构可以推断Dagger 将搜索实现委托给 ripgrep这是搜索性能与语义的基石——DirectorySearchOpts的每个布尔选项都直接映射为 rg 的 CLI 标志。参数详解10 个字段的语义、默认值与底层映射后端核心参数定义在 core/search.go 的SearchOpts结构体中字段默认值标注清晰。DirectorySearchOpts的字段与之一一对应。pattern必填搜索模式pattern: string是要匹配的文本DirectorySearchOpts中唯一必填项。默认按Rust 正则语法解析与 ripgrep 一致因此字面特殊字符.、[、]、{、}、|需要用反斜杠转义例如pattern: foo\\.bar支持\w、\s、\d、分组、锚点等标准正则能力若想完全按字面量匹配配合literal: true使用。后端会将其拼为 ripgrep 的--regexppattern参数core/search.go。paths限定搜索范围paths?: string[]指定要搜索的具体目录或文件路径例如paths: [src, README.md]。后端对每个路径执行三重安全检查core/directory.go绝对路径会去掉前导/转为相对路径调用filepath.Clean规范化路径移除./、../等通过filepath.IsLocal校验任何试图逃逸出目标目录的路径都会直接报错path cannot escape directory从根上防御目录穿越攻击。通过校验后路径会作为 rg 的--分隔符后的位置参数传入core/directory.go。globs按 glob 模式过滤文件globs?: string[]用 glob 模式过滤参与搜索的文件例如globs: [*.md]只搜索 Markdown 文件。底层映射为 ripgrep 的--globglob参数core/directory.go。支持标准的*、**、?、{a,b}语法并可配合!前缀排除如!vendor/**。literal按字面量匹配literal?: boolean默认false。为true时模式被当作纯文本而非正则。后端映射为 rg 的--fixed-strings标志core/search.go。当搜索包含大量正则特殊字符的业务标识符如C、v1.2.3时这是最省心的选择。multiline跨行搜索multiline?: boolean默认false。开启后模式可以跨越多行匹配例如pattern: func \\w\\(\\)配合multiline: true可匹配跨行的函数定义。后端映射为--multilinecore/search.go。集成测试中: Alice\n\tage这类跨行模式正是依赖此选项core/integration/directory_test.go。dotall让 . 匹配换行dotall?: boolean默认false。仅在 multiline 模式下有意义让.也能匹配换行符从而允许类似.*跨行贪婪匹配。后端映射为--multiline-dotallcore/search.go。insensitive大小写不敏感insensitive?: boolean默认false。开启后忽略大小写。后端映射为--ignore-casecore/search.go。测试用例验证文件内容为Hello\nhello\nHELLO时insensitive: true搜索hello会返回 3 个结果行号分别为 1、2、3core/integration/directory_test.go。skipIgnored尊重忽略文件skipIgnored?: boolean默认false。为true时尊重.gitignore、.ignore、.rgignore文件跳过其中忽略的文件。注意默认值为 false 的语义后端在skipIgnored为 false 时会显式追加--no-ignorecore/search.go即默认情况下忽略规则不生效、所有文件都会参与搜索。skipHidden跳过隐藏文件skipHidden?: boolean默认false。为true时跳过以.开头的隐藏文件。同样默认 false 时后端追加--hidden标志core/search.go即默认包含隐藏文件。filesOnly只返回文件名filesOnly?: boolean默认false。为true时只返回命中的文件路径不返回行内容与子匹配。后端切换为--files-with-matches并使用纯文本行解析core/search.go解析逻辑见 core/search.go。返回的SearchResult仅填充filePathlineNumber为 0、matchedLines为空——这在只需要“哪些文件包含某内容”时能显著减少数据传输量。limit限制结果数量limit?: number默认无限制。限制返回的结果总数。实现细节ripgrep 本身没有“限制总结果数”的标志只有每文件限制因此 Dagger 在解析输出时计数并提前终止core/search.go 与 core/search.go。测试验证设置Limit: 3后结果恰好为 3 条core/integration/directory_test.go。参数速查表字段类型必填默认值底层 rg 参数作用patternstring✅—--regexp要匹配的文本Rust 正则pathsstring[]❌[]位置参数限定搜索的目录/文件globsstring[]❌[]--glob按 glob 过滤文件literalboolean❌false--fixed-strings按字面量匹配multilineboolean❌false--multiline跨行搜索dotallboolean❌false--multiline-dotall.匹配换行insensitiveboolean❌false--ignore-case忽略大小写skipIgnoredboolean❌false--no-ignore反向尊重忽略文件skipHiddenboolean❌false--hidden反向跳过隐藏文件filesOnlyboolean❌false--files-with-matches只返回文件名limitnumber❌无输出解析阶段计数限制结果总数实战示例从 TypeScript 到 GoTypeScript基础搜索import { connect } from dagger.io/dagger connect(async (client) { // 搜索仓库中所有 Markdown 文件里的 TODO忽略大小写 const results await client.host().directory(.) .search({ pattern: TODO, globs: [*.md], insensitive: true, }) for (const r of results) { console.log(${r.filePath}:${r.lineNumber}: ${r.matchedLines}) } })TypeScript限定路径 正则 限制条数// 只搜索 src 目录正则匹配函数调用最多返回 10 条 const results await client.host().directory(.) .search({ pattern: \\bdoWork\\s*\\(, paths: [src], limit: 10, })TypeScript只列出命中文件// 找出包含 password 的配置文件清单 const files await client.host().directory(./config) .search({ pattern: password, literal: true, filesOnly: true, }) // files 中每个元素的 filePath 即为命中文件Go SDK 对应写法Go SDK 中同样的能力通过dagger.DirectorySearchOpts结构体提供见生成的 sdk/go/dagger.gen.goresults, err : dir.Search(ctx, World, dagger.DirectorySearchOpts{ FilesOnly: true, })其方法与后端SearchOpts字段Literal、Multiline、Dotall、Insensitive、SkipIgnored、SkipHidden、FilesOnly、Limit一一对应Go 版本还额外提供Paths []string与Globs []string两个顶层字段与DirectorySearchOpts.paths/globs等价。底层原理结果解析与边界行为结果如何被解析非filesOnly模式下rg 以--json输出core/search.goDagger 逐条解码 JSON 流并过滤非match类型的事件core/search.go。解码过程中命中行内容与路径若包含非 UTF-8 字节会被跳过并记录 warningcore/search.go每个匹配的精确位置start/end和文本被存入SearchSubmatch用于高亮展示core/search.go空目录如llb.Scratch()直接返回空结果不启动 rgcore/directory.go。几个值得注意的边界行为默认跟随忽略与隐藏规则被反转如前所述Dagger 默认不尊重.gitignore且包含隐藏文件。这是与一般代码搜索工具相反的设计定位需求时需格外注意禁止符号链接穿越rg 启动时始终追加--no-follow显式禁止跟随符号链接core/search.go无匹配返回空数组而非错误rg 退出码 1无匹配被当作正常结果返回空列表core/search.go二进制文件被跳过集成测试确认含随机字节的二进制文件不会出现在结果中core/integration/directory_test.go路径逃逸直接报错../等越界路径会在校验阶段被拒绝core/directory.go。搜索结果的可持久化SearchResult与SearchSubmatch都实现了dagql.PersistedObject支持在 Dagger 的持久化对象缓存中编码/解码core/search.go这使得搜索结果可以作为 DAG 中间产物被缓存复用而无需重新执行搜索。与 FileSearchOpts 的关系同一搜索能力也作用于单个文件File.search()接受FileSearchOpts定义见 docs/versioned_docs/version-0.19/reference/typescript/api/client.gen/type-aliases/FileSearchOpts.md。两者的字段几乎完全相同区别仅在于DirectorySearchOpts额外拥有paths与globs目录场景下定位/过滤范围FileSearchOpts没有范围限定字段直接对单个文件执行搜索两者共享同一套pattern、literal、multiline、dotall、insensitive、skipIgnored、skipHidden、filesOnly、limit选项与底层 rg 映射逻辑。后端对应实现分别是Directory.Search()core/directory.go与File.Search()core/file.goschema 层的文档注释也明确注明需与File.search保持同步core/schema/directory.go。常见场景与最佳实践场景推荐配置快速统计哪些文件含 TODOpattern: TODO,filesOnly: true大小写不敏感搜索pattern: hello,insensitive: true搜索精确版本号等特殊字符串pattern: v1.2.3,literal: true跨行匹配多行语句pattern: if \\\\(.{\\\\}\\\\),multiline: true只查源码目录、排除构建产物paths: [src],globs: [*.{go,ts}]防止结果过多limit: 100找到包含敏感词的配置文件literal: true,paths: [config]总结DirectorySearchOpts是 Dagger 目录内容搜索能力的统一配置入口一个必填的pattern加上 10 个可选开关即可精细控制匹配模式、范围、大小写、跨行行为、忽略规则、隐藏文件、输出粒度与结果上限。其底层由引擎内置的 ripgrep 驱动并经过了路径穿越防护、二进制文件跳过、结果持久化等工程化加固是构建“代码库分析流水线”“合规扫描”“文档质量检查”等 Dagger 模块的得力工具。想要深入阅读实现可从 core/search.go 与 core/integration/directory_test.go 入手结合测试用例理解每个选项的实际行为边界。【免费下载链接】daggerAutomation engine to build, test and ship any codebase. Runs locally, in CI, or directly in the cloud项目地址: https://gitcode.com/GitHub_Trending/da/dagger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Dagger DirectorySearchOpts 完全指南：在 Dagger Directory 中执行高性能内容搜索
Dagger DirectorySearchOpts 完全指南在 Dagger Directory 中执行高性能内容搜索【免费下载链接】daggerAutomation engine to build, test and ship any codebase. Runs locally, in CI, or directly in the cloud项目地址: https://gitcode.com/GitHub_Trending/da/dagger导读本文系统讲解 Dagger 0.19 中Directory对象的核心搜索 API ——DirectorySearchOpts类型别名及其背后的Directory.search()方法。它让你在 Dagger 引擎管理的容器文件系统中以正则或字面量模式扫描目录内容并返回包含文件路径、行号、字节偏移与精确子匹配位置的SearchResult列表。读完本文你将掌握DirectorySearchOpts全部 10 个字段的语义与默认值、底层 ripgrep 的映射原理、与FileSearchOpts的关系并能直接写出可运行的 TypeScript/Go 搜索代码。DirectorySearchOpts 是什么在 Dagger 的 TypeScript SDK 中DirectorySearchOpts是一个用于配置Directory.search()调用的类型别名本质是一个对象类型。其官方定义位于 docs/versioned_docs/version-0.19/reference/typescript/api/client.gen/type-aliases/DirectorySearchOpts.md完整类型声明如下export type DirectorySearchOpts { /** * Directory or file paths to search */ paths?: string[] /** * Glob patterns to match (e.g., *.md) */ globs?: string[] /** * The text to match. */ pattern: string /** * Interpret the pattern as a literal string instead of a regular expression. */ literal?: boolean /** * Enable searching across multiple lines. */ multiline?: boolean /** * Allow the . pattern to match newlines in multiline mode. */ dotall?: boolean /** * Enable case-insensitive matching. */ insensitive?: boolean /** * Honor .gitignore, .ignore, and .rgignore files. */ skipIgnored?: boolean /** * Skip hidden files (files starting with .). */ skipHidden?: boolean /** * Only return matching files, not lines and content */ filesOnly?: boolean /** * Limit the number of results to return */ limit?: number }该定义与 SDK 源码中的生成类型 sdk/typescript/src/api/client.gen.ts 完全一致。它由 Dagger 的 codegen 工具根据 GraphQL 内省结果自动生成因此字段名与语义必须与后端 Go 实现严格同步——这正是DirectorySearchOpts能跨 TypeScript、Go、Python 等 SDK 保持一致行为的根本原因。值得注意的是pattern是唯一必填字段其余字段全部可选。这意味着最小调用只需一个搜索词dir.search({ pattern: TODO })。核心概念Directory.search 搜索从何而来类型别名背后的真正 APIDirectorySearchOpts不是孤立存在的它是Directory.search()方法的参数类型。在 TypeScript SDK 中该方法定义于 sdk/typescript/src/api/client.gen.ts签名与文档注释如下/** * Searches for content matching the given regular expression or literal string. * * Uses Rust regex syntax; escape literal ., [, ], {, }, | with backslashes. * param opts.paths Directory or file paths to search * param opts.globs Glob patterns to match (e.g., *.md) * ... */ search async (opts?: DirectorySearchOpts): PromiseSearchResult[]它返回SearchResult[]每个结果包含 5 个字段见 core/search.go字段类型含义filePathstring命中的文件路径lineNumbernumber命中的首行行号从 1 开始absoluteOffsetnumber该行在文件内的字节偏移量matchedLinesstring命中的行内容submatchesSearchSubmatch[]子匹配的位置与内容text、start、end搜索是在 Dagger 引擎内执行的Directory.search不是客户端本地搜索而是由 Dagger 引擎在容器化的目录快照上执行。整条调用链为TypeScript/Go 客户端通过 GraphQL 发出search查询参数由DirectorySearchOpts序列化GraphQL schema 层在 core/schema/directory.go 注册search节点函数并组合了core.SearchOpts的全部参数与额外的paths、globsschema 处理器调用核心实现Directory.Search()core/directory.go它挂载目录快照、校验路径然后启动ripgreprg二进制进程执行实际搜索输出结果被解析为SearchResult对象返回。从源码结构可以推断Dagger 将搜索实现委托给 ripgrep这是搜索性能与语义的基石——DirectorySearchOpts的每个布尔选项都直接映射为 rg 的 CLI 标志。参数详解10 个字段的语义、默认值与底层映射后端核心参数定义在 core/search.go 的SearchOpts结构体中字段默认值标注清晰。DirectorySearchOpts的字段与之一一对应。pattern必填搜索模式pattern: string是要匹配的文本DirectorySearchOpts中唯一必填项。默认按Rust 正则语法解析与 ripgrep 一致因此字面特殊字符.、[、]、{、}、|需要用反斜杠转义例如pattern: foo\\.bar支持\w、\s、\d、分组、锚点等标准正则能力若想完全按字面量匹配配合literal: true使用。后端会将其拼为 ripgrep 的--regexppattern参数core/search.go。paths限定搜索范围paths?: string[]指定要搜索的具体目录或文件路径例如paths: [src, README.md]。后端对每个路径执行三重安全检查core/directory.go绝对路径会去掉前导/转为相对路径调用filepath.Clean规范化路径移除./、../等通过filepath.IsLocal校验任何试图逃逸出目标目录的路径都会直接报错path cannot escape directory从根上防御目录穿越攻击。通过校验后路径会作为 rg 的--分隔符后的位置参数传入core/directory.go。globs按 glob 模式过滤文件globs?: string[]用 glob 模式过滤参与搜索的文件例如globs: [*.md]只搜索 Markdown 文件。底层映射为 ripgrep 的--globglob参数core/directory.go。支持标准的*、**、?、{a,b}语法并可配合!前缀排除如!vendor/**。literal按字面量匹配literal?: boolean默认false。为true时模式被当作纯文本而非正则。后端映射为 rg 的--fixed-strings标志core/search.go。当搜索包含大量正则特殊字符的业务标识符如C、v1.2.3时这是最省心的选择。multiline跨行搜索multiline?: boolean默认false。开启后模式可以跨越多行匹配例如pattern: func \\w\\(\\)配合multiline: true可匹配跨行的函数定义。后端映射为--multilinecore/search.go。集成测试中: Alice\n\tage这类跨行模式正是依赖此选项core/integration/directory_test.go。dotall让 . 匹配换行dotall?: boolean默认false。仅在 multiline 模式下有意义让.也能匹配换行符从而允许类似.*跨行贪婪匹配。后端映射为--multiline-dotallcore/search.go。insensitive大小写不敏感insensitive?: boolean默认false。开启后忽略大小写。后端映射为--ignore-casecore/search.go。测试用例验证文件内容为Hello\nhello\nHELLO时insensitive: true搜索hello会返回 3 个结果行号分别为 1、2、3core/integration/directory_test.go。skipIgnored尊重忽略文件skipIgnored?: boolean默认false。为true时尊重.gitignore、.ignore、.rgignore文件跳过其中忽略的文件。注意默认值为 false 的语义后端在skipIgnored为 false 时会显式追加--no-ignorecore/search.go即默认情况下忽略规则不生效、所有文件都会参与搜索。skipHidden跳过隐藏文件skipHidden?: boolean默认false。为true时跳过以.开头的隐藏文件。同样默认 false 时后端追加--hidden标志core/search.go即默认包含隐藏文件。filesOnly只返回文件名filesOnly?: boolean默认false。为true时只返回命中的文件路径不返回行内容与子匹配。后端切换为--files-with-matches并使用纯文本行解析core/search.go解析逻辑见 core/search.go。返回的SearchResult仅填充filePathlineNumber为 0、matchedLines为空——这在只需要“哪些文件包含某内容”时能显著减少数据传输量。limit限制结果数量limit?: number默认无限制。限制返回的结果总数。实现细节ripgrep 本身没有“限制总结果数”的标志只有每文件限制因此 Dagger 在解析输出时计数并提前终止core/search.go 与 core/search.go。测试验证设置Limit: 3后结果恰好为 3 条core/integration/directory_test.go。参数速查表字段类型必填默认值底层 rg 参数作用patternstring✅—--regexp要匹配的文本Rust 正则pathsstring[]❌[]位置参数限定搜索的目录/文件globsstring[]❌[]--glob按 glob 过滤文件literalboolean❌false--fixed-strings按字面量匹配multilineboolean❌false--multiline跨行搜索dotallboolean❌false--multiline-dotall.匹配换行insensitiveboolean❌false--ignore-case忽略大小写skipIgnoredboolean❌false--no-ignore反向尊重忽略文件skipHiddenboolean❌false--hidden反向跳过隐藏文件filesOnlyboolean❌false--files-with-matches只返回文件名limitnumber❌无输出解析阶段计数限制结果总数实战示例从 TypeScript 到 GoTypeScript基础搜索import { connect } from dagger.io/dagger connect(async (client) { // 搜索仓库中所有 Markdown 文件里的 TODO忽略大小写 const results await client.host().directory(.) .search({ pattern: TODO, globs: [*.md], insensitive: true, }) for (const r of results) { console.log(${r.filePath}:${r.lineNumber}: ${r.matchedLines}) } })TypeScript限定路径 正则 限制条数// 只搜索 src 目录正则匹配函数调用最多返回 10 条 const results await client.host().directory(.) .search({ pattern: \\bdoWork\\s*\\(, paths: [src], limit: 10, })TypeScript只列出命中文件// 找出包含 password 的配置文件清单 const files await client.host().directory(./config) .search({ pattern: password, literal: true, filesOnly: true, }) // files 中每个元素的 filePath 即为命中文件Go SDK 对应写法Go SDK 中同样的能力通过dagger.DirectorySearchOpts结构体提供见生成的 sdk/go/dagger.gen.goresults, err : dir.Search(ctx, World, dagger.DirectorySearchOpts{ FilesOnly: true, })其方法与后端SearchOpts字段Literal、Multiline、Dotall、Insensitive、SkipIgnored、SkipHidden、FilesOnly、Limit一一对应Go 版本还额外提供Paths []string与Globs []string两个顶层字段与DirectorySearchOpts.paths/globs等价。底层原理结果解析与边界行为结果如何被解析非filesOnly模式下rg 以--json输出core/search.goDagger 逐条解码 JSON 流并过滤非match类型的事件core/search.go。解码过程中命中行内容与路径若包含非 UTF-8 字节会被跳过并记录 warningcore/search.go每个匹配的精确位置start/end和文本被存入SearchSubmatch用于高亮展示core/search.go空目录如llb.Scratch()直接返回空结果不启动 rgcore/directory.go。几个值得注意的边界行为默认跟随忽略与隐藏规则被反转如前所述Dagger 默认不尊重.gitignore且包含隐藏文件。这是与一般代码搜索工具相反的设计定位需求时需格外注意禁止符号链接穿越rg 启动时始终追加--no-follow显式禁止跟随符号链接core/search.go无匹配返回空数组而非错误rg 退出码 1无匹配被当作正常结果返回空列表core/search.go二进制文件被跳过集成测试确认含随机字节的二进制文件不会出现在结果中core/integration/directory_test.go路径逃逸直接报错../等越界路径会在校验阶段被拒绝core/directory.go。搜索结果的可持久化SearchResult与SearchSubmatch都实现了dagql.PersistedObject支持在 Dagger 的持久化对象缓存中编码/解码core/search.go这使得搜索结果可以作为 DAG 中间产物被缓存复用而无需重新执行搜索。与 FileSearchOpts 的关系同一搜索能力也作用于单个文件File.search()接受FileSearchOpts定义见 docs/versioned_docs/version-0.19/reference/typescript/api/client.gen/type-aliases/FileSearchOpts.md。两者的字段几乎完全相同区别仅在于DirectorySearchOpts额外拥有paths与globs目录场景下定位/过滤范围FileSearchOpts没有范围限定字段直接对单个文件执行搜索两者共享同一套pattern、literal、multiline、dotall、insensitive、skipIgnored、skipHidden、filesOnly、limit选项与底层 rg 映射逻辑。后端对应实现分别是Directory.Search()core/directory.go与File.Search()core/file.goschema 层的文档注释也明确注明需与File.search保持同步core/schema/directory.go。常见场景与最佳实践场景推荐配置快速统计哪些文件含 TODOpattern: TODO,filesOnly: true大小写不敏感搜索pattern: hello,insensitive: true搜索精确版本号等特殊字符串pattern: v1.2.3,literal: true跨行匹配多行语句pattern: if \\\\(.{\\\\}\\\\),multiline: true只查源码目录、排除构建产物paths: [src],globs: [*.{go,ts}]防止结果过多limit: 100找到包含敏感词的配置文件literal: true,paths: [config]总结DirectorySearchOpts是 Dagger 目录内容搜索能力的统一配置入口一个必填的pattern加上 10 个可选开关即可精细控制匹配模式、范围、大小写、跨行行为、忽略规则、隐藏文件、输出粒度与结果上限。其底层由引擎内置的 ripgrep 驱动并经过了路径穿越防护、二进制文件跳过、结果持久化等工程化加固是构建“代码库分析流水线”“合规扫描”“文档质量检查”等 Dagger 模块的得力工具。想要深入阅读实现可从 core/search.go 与 core/integration/directory_test.go 入手结合测试用例理解每个选项的实际行为边界。【免费下载链接】daggerAutomation engine to build, test and ship any codebase. Runs locally, in CI, or directly in the cloud项目地址: https://gitcode.com/GitHub_Trending/da/dagger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考