当前位置：首页 > 文章列表 > Golang > Go教程 > Golang配置文件读取方法全解析

Golang配置文件读取方法全解析

2026-01-26 22:46:56 0浏览收藏

大家好，我们又见面了啊~本文《Golang读取配置文件方法大全》的内容中将会涉及到等等。如果你正在学习Golang相关知识，欢迎关注我，以后会给大家带来更多Golang相关文章，希望我们能一起进步！下面就开始本文的正式内容~

答案：Golang中推荐使用Viper库读取JSON、YAML等格式的配置文件，支持环境变量、默认值及热更新，结构化配置便于维护；小项目可用标准库encoding/json解析JSON文件。

如何在Golang中读取配置文件

在Golang中读取配置文件，常用的方式是结合第三方库来解析JSON、YAML或TOML格式的配置。虽然标准库支持基本的INI格式（通过flag或手动处理），但更推荐使用结构化格式配合成熟库实现清晰、易维护的配置管理。

使用Viper读取多种格式配置文件

Viper 是 Go 中最流行的配置管理库，支持 JSON、YAML、TOML、ENV、命令行参数等多种来源，并能自动监听文件变化。

安装 Viper：

// go.mod 文件中添加
require github.com/spf13/viper v1.16.0

示例：读取 config.yaml

package main

import (
  "fmt"
  "github.com/spf13/viper"
)

type Config struct {
  ServerPort int `mapstructure:"server_port"`
  Database DB `mapstructure:"database"`
  Debug bool `mapstructure:"debug"`
}

type DB struct {
  Host string `mapstructure:"host"`
  Name string `mapstructure:"name"`
}

func main() {
  // 设置文件名和路径
  viper.SetConfigName("config") // 不带后缀
  viper.SetConfigType("yaml") // 可选: "json", "toml", "yaml"
  viper.AddConfigPath(".") // 当前目录

  err := viper.ReadInConfig()
  if err != nil {
    panic(fmt.Errorf("读取配置失败: %s", err))
  }

  var cfg Config
  err = viper.Unmarshal(&cfg)
  if err != nil {
    panic(fmt.Errorf("解析配置失败: %s", err))
  }

  fmt.Printf("配置: %+v\n", cfg)
}

对应 config.yaml 文件内容：

server_port: 8080
debug: true
database:
host: localhost
name: myapp_db

直接使用标准库解析JSON

如果不想引入外部依赖，可以用 encoding/json 处理 JSON 配置文件。

package main

import (
  "encoding/json"
  "io/ioutil"
  "log"
)

func loadConfig(filename string) (*Config, error) {
  data, err := ioutil.ReadFile(filename)
  if err != nil {
    return nil, err
  }

  var cfg Config
  err = json.Unmarshal(data, &cfg)
  if err != nil {
    return nil, err
  }
  return &cfg, nil
}

调用方式：

cfg, err := loadConfig("config.json")
if err != nil {
log.Fatal(err)
}
fmt.Printf("端口: %d\n", cfg.ServerPort)