读取配置文件
加载 YAML、JSON、TOML
读取配置文件 是 CoddyKit 上的免费 Go Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
配置位于代码之外
将端口、主机名和超时时间等值硬编码到 Go 程序中很脆弱。Viper 是 Go 中事实上的配置库：它可以从文件、环境变量、标志和远程存储中读取设置。
本课将从磁盘上的文件加载配置。
Viper 支持读取哪些格式
Viper 开箱即支持多种格式：
- YAML（
.yaml/.yml） - JSON（
.json） - TOML（
.toml） - HCL、INI 和 Java 属性文件
您可以使用 SetConfigType 选择格式，也可以让 Viper 从文件扩展名推断格式。
安装并导入 Viper
将 Viper 添加到您的模块并导入：
go get github.com/spf13/viperimport "github.com/spf13/viper"
由于 Viper 是外部依赖，导入它的代码片段无法在本课播放器中运行。我们会在可行的地方使用标准库模拟其行为。
import "github.com/spf13/viper"告诉 Viper 在哪里查找
在读取之前配置文件名、类型和搜索路径：
viper.SetConfigName("config")设置基本名称（不含扩展名）viper.SetConfigType("yaml")设置格式viper.AddConfigPath(".")添加要搜索的目录
viper.SetConfigName("config")
viper.SetConfigType("yaml")
viper.AddConfigPath(".")
viper.AddConfigPath("/etc/myapp")读取文件
调用 viper.ReadInConfig() 加载文件。它会返回一个您必须检查的错误：
- 文件缺失时返回
ConfigFileNotFoundError - 文件格式错误时返回解析错误
if err := viper.ReadInConfig(); err != nil {
log.Fatalf("failed to read config: %v", err)
}示例 YAML 配置
假设有如下所示的 config.yaml。Viper 会使用点号展开嵌套键，因此端口会变成 server.port。
server:
port: 8080
host: "localhost"
debug: true获取带类型的值
Viper 提供带类型的获取方法，因此您无需手动转换：
viper.GetInt("server.port")viper.GetString("server.host")viper.GetBool("debug")
port := viper.GetInt("server.port")
host := viper.GetString("server.host")
debug := viper.GetBool("debug")
fmt.Println(host, port, debug)JSON 的工作方式相同
切换到 JSON 只需更改文件内容和配置类型。相同的键路径和获取方法仍然适用。这种可移植性正是 Viper 广受欢迎的原因：无论运维人员选择哪种格式，您的代码都无需关心。
{
"server": { "port": 8080, "host": "localhost" },
"debug": true
}TOML 同样受支持
TOML 在 Go 生态系统中很常见（许多命令行工具都使用它）。相同的嵌套键会映射到点号路径。
[server]
port = 8080
host = "localhost"
debug = true使用标准库解析 JSON
为了实际了解其工作原理，下面使用普通 Go 代码，仅通过 encoding/json 将 JSON 配置解析到映射中，不使用 Viper（Viper 本身在底层也使用通用映射）。
package main
import (
"encoding/json"
"fmt"
)
func main() {
raw := "{\"port\":8080,\"host\":\"localhost\"}"
var c map[string]any
if err := json.Unmarshal([]byte(raw), &c); err != nil {
panic(err)
}
fmt.Printf("%v:%v\n", c["host"], c["port"])
}可运行示例：读取到映射中
这个自包含程序会将 JSON 配置解析到通用映射中并输出值，模拟 Viper 在底层处理 JSON 的方式。
package main
import (
"encoding/json"
"fmt"
)
func main() {
raw := "{\"port\":8080,\"host\":\"localhost\"}"
var m map[string]any
json.Unmarshal([]byte(raw), &m)
fmt.Println("host:", m["host"])
fmt.Println("port:", m["port"])
}快速检查
测试您对使用 Viper 读取配置文件的理解。
回顾
您学到了 Viper 如何读取配置文件：
- 它可以透明地支持 YAML、JSON 和 TOML
- 使用
SetConfigName、SetConfigType、AddConfigPath进行配置 ReadInConfig()会加载文件并返回错误- 使用
GetInt和GetString等带类型的获取方法，通过点号键读取值
下一步：使用环境变量覆盖配置。
常见问题解答
「读取配置文件」课时是免费的吗？
是的 — 「读取配置文件」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「读取配置文件」这节课中我会学到什么？
加载 YAML、JSON、TOML 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「读取配置文件」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。