本文档提供了标准 Go 项目布局中与配置相关的目录的全面概述。它涵盖了存储配置文件、初始化脚本和部署设置的各种目录的结构、目的和使用模式。有关构建基础设施的信息，请参阅 构建基础设施。
配置管理是任何软件项目的关键方面。标准 Go 项目布局提供了专门的目录来组织不同类型的配置文件，以保持关注点分离和提高可维护性。
标准 Go 项目布局中的主要配置目录包括
| 目录 | 目的 | 配置类型 |
|---|---|---|
/configs | 存储应用程序配置文件和模板 | 应用程序级别配置 |
/init | 包含系统初始化和进程管理器配置 | 服务启动配置 |
/deployments | 存放适用于不同环境的特定于部署的配置 | 基础设施配置 |
来源： README.md114-118 README.md120-122 README.md140-142
`/configs` 目录用于存放应用程序的配置文件模板或默认配置。这些可以是以 YAML、JSON、TOML 格式的配置文件，或特定于环境的配置文件。
组织 `/configs` 目录的常见模式包括
`/configs` 目录尤其适合与配置管理工具一起使用的模板文件。例如
来源： README.md114-118
`/init` 目录包含系统初始化配置和进程管理器设置文件。这些配置定义了您的应用程序应如何被操作系统或容器环境启动、监控和管理。
`/init` 目录通常包含
| 系统类型 | 文件格式 | 描述 |
|---|---|---|
| systemd | .service 文件 | 定义在基于 systemd 的系统上如何启动/停止/重启服务的单元文件 |
| upstart | .conf 文件 | Upstart init 系统的作业配置 |
| sysv | Init 脚本 | 传统的 SysV 风格的 init 脚本 |
| supervisor | .conf 文件 | 进程控制系统配置 |
| runit | Run 脚本 | 服务监控配置 |
这些文件可确保您的应用程序能够被宿主系统的进程管理工具正确管理。
来源： README.md120-122
`/deployments` 目录包含将应用程序部署到各种环境和平台的配置文件和模板。它侧重于基础设施配置，而不是应用程序配置。
`/deployments` 目录通常包含
在某些存储库中，特别是那些部署在 Kubernetes 上的存储库，此目录的名称可能是 `/deploy` 而不是 `/deployments`。
来源： README.md140-142
配置目录与标准 Go 项目布局中的其他目录有着重要的关系
关键关系包括
配置与应用程序代码：`/cmd` 和 `/internal` 目录中的应用程序代码使用 `/configs` 目录中的配置。
构建和部署管道：`/build` 目录包含 CI/CD 配置，这些配置通常引用 `/deployments` 目录中的部署配置。
脚本与配置：`/scripts` 目录中的脚本可以管理、转换或验证配置文件。
来源： README.md58-66 README.md126-138 README.md124-130
保持清晰分离
来源： README.md114-118 README.md140-142
标准 Go 项目布局中的配置目录为不同类型的配置提供了有组织的存放位置
正确组织这些目录可确保配置关注点分离，使应用程序更易于部署、维护和适应不同环境。虽然推荐使用这些目录，但并非所有项目都需要所有目录，其确切结构可以根据项目的具体需求进行调整。