Go buildutil.ExpandPatterns 怎样展开包路径模式

buildutil.ExpandPatterns(ctxt, patterns) 根据 go/build.Context 展开包路径选择规则，返回 map[string]bool 集合。常用形式是精确包路径、结尾为 /... 的子树，以及表示整个可见工作区的 ...。以减号开头的模式会从当前集合中删除匹配项，因此模式顺序会影响结果。

官方地址：https://pkg.go.dev/golang.org/x/tools/go/buildutil

先限定它处理的是哪类工作区

这个函数建立在 go/build 的上下文模型上，通配展开围绕该上下文的源码目录，例如 GOROOT 和 GOPATH 的 src 目录。不要因为函数名里有 Patterns，就把它当成当前 Go 命令全部包模式语法的等价实现。

如果维护的是基于 go/build 的旧分析工具，它可以把已有的选择规则展开为路径集合。若目标是解析 go.mod、go.work 对应的现代模块工程，应评估 go/packages 等按构建工具加载包的入口，而不是仅切换当前目录，就期待 ExpandPatterns 获得完整模块图。

接入之前还应明确允许用户选择的范围。这里的排除模式是任务选择规则，不是文件系统权限隔离，也不会改变调用进程本来拥有的读取权限。

把模式列表展开为稳定的路径清单

下面的封装使用 build.Default 的副本，保留调用进程原有的构建上下文；结果从 map 转成经过排序的路径切片，方便后续保存选择清单。

package selection

import (
    "go/build"
    "sort"

    "golang.org/x/tools/go/buildutil"
)

// ExpandSelected 以当前默认构建上下文展开模式，并返回排序后的包路径。
func ExpandSelected(patterns []string) []string {
    // 复制上下文，避免本函数为配置调整而修改全局 build.Default。
    ctxt := build.Default
    selected := buildutil.ExpandPatterns(&ctxt, patterns)
    paths := make([]string, 0, len(selected))
    for path, included := range selected {
        if included {
            paths = append(paths, path)
        }
    }
    // map 遍历顺序不固定，输出前排序便于日志和任务记录比较。
    sort.Strings(paths)
    return paths
}

// ExampleSelection 演示先包含、再排除、最后重新包含的规则。
func ExampleSelection() []string {
    return ExpandSelected([]string{
        "net/...",
        "-net/http/...",
        "net/http/httptest",
    })
}

项目需要依赖 golang.org/x/tools 模块，具体版本按项目约束确定。示例中的 net 路径用于表达选择意图，不附带某台机器上的实际枚举结果。不同 Go 安装和源码目录会影响可见候选，不能写死一个预期包总数作为通用结果。

包含和排除必须按原始顺序解释

示例先纳入 net 子树，再移除 net/http 子树，最后显式加入 net/http/httptest。最后一项是在排除之后执行的重新加入，不能把所有减号模式集中到末尾，否则就改变了用户原先的选择语义。

重复加入精确路径会由集合去重。仅有排除模式、没有先加入的项目时，不会自动生成“所有包减去这些包”的补集。尾部斜线会被忽略；包路径使用斜线分隔，不应按操作系统路径分隔符改写。

展开结果还不能代表包可以构建

从官方实现可以看到，精确路径分支直接写入集合；它不是对每个路径执行一次 Import 或构建。因此一个拼错的精确路径也可能出现在返回值中。此函数签名没有 error 返回值，不能写成两个返回变量，更不能把“函数正常返回”解释成依赖完整、类型正确或能够编译。

通配候选使用的枚举也可能包含没有 Go 源文件的目录。需要真正分析或构建时，应由后续加载或构建环节处理相应错误，并在报告中区分“被选中”和“加载成功”。这两个状态若共用一个成功标记，容易让操作者误以为选择清单就是可执行清单。

官方源码还列出了尚未支持的 Go 命令模式能力，包括 std、cmd、all 这类元包、非末尾的省略号以及 ./、../ 相对模式。不要把任意 go list 输入原样交给这个函数后，就假定含义相同；尤其 ./... 不应当作当前模块全量发现的通用写法。

接入自动任务时保留环境和选择记录

自动任务最好保留原始模式列表及其顺序、展开后排序的路径列表，以及用于解释选择范围的上下文信息。记录里明确区分“显式加入路径”与“通配发现范围”，排障时才容易发现是模式语义变化，还是机器上的源码布局不同。

包含通配模式时，实现可能枚举整个上下文可见工作区，而不是只读最终留下来的几个路径。把排除模式写得很多，不代表目录扫描成本就一定很小。若工作区范围过大，应先评估任务入口、目录布局与所需包范围，不凭函数名推断性能。

如果使用自定义 build.Context 文件系统接口，还要遵守其并发安全要求。本例复制 build.Default 只是避免修改全局配置；它不会自动为自定义回调增加锁，也不构成深层资源隔离。

常见问题：返回的是有序切片吗？不是，原生返回 map，示例自行排序。减号模式能永久禁止某个包吗？不能，后面的包含规则可以重新加入。它会下载缺失模块吗？不能把它当模块解析与下载入口。清单里有某个包就说明它能构建吗？不说明，还需要真正的包加载或构建结果。

参考：ExpandPatterns 官方文档；模式展开与工作区枚举实现。