首页 > Golang > Go教程

Golang读取INI配置文件教程

时间：2026-01-11 22:52:04 174浏览收藏

哈喽！今天心血来潮给大家带来了《Golang读取INI配置文件方法详解》，想必大家应该对Golang都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习Golang，千万别错过这篇文章~希望能帮助到你！

使用go-ini库可高效读取INI配置文件。先通过go get安装库，创建config.ini文件包含database和server段，用ini.Load加载并读取键值，支持Int、Bool等类型转换。还可通过ini.MapTo将配置映射到结构体，提升代码可维护性。使用MustInt、MustString等方法设置默认值，增强程序健壮性。注意文件路径与权限管理。

如何在Golang中读取INI配置文件_Golang INI配置文件操作实践

在Go语言项目开发中，配置文件是管理应用参数的重要方式。INI格式因其结构清晰、易于阅读，被广泛用于中小型项目。Golang标准库没有内置对INI文件的支持，但通过第三方库可以高效实现读取和操作。本文介绍如何使用流行的go-ini/ini库来读取和操作INI配置文件。

安装 go-ini 库

首先需要安装 github.com/go-ini/ini 这个常用的INI操作库：

go get github.com/go-ini/ini

编写一个简单的 INI 配置文件

创建名为 config.ini 的文件，内容如下：

[database]
host = localhost
port = 3306
user = root
password = 123456
dbname = myapp

[server]
addr = :8080
timeout = 30
enable_gzip = true

读取 INI 配置文件

使用以下代码加载并读取配置项：

package main

import (
    "fmt"
    "log"

    "github.com/go-ini/ini"
)

func main() {
    cfg, err := ini.Load("config.ini")
    if err != nil {
        log.Fatal("无法加载配置文件:", err)
    }

    // 获取 database 段
    dbHost := cfg.Section("database").Key("host").String()
    dbPort, _ := cfg.Section("database").Key("port").Int()
    dbUser := cfg.Section("database").Key("user").String()
    dbPass := cfg.Section("database").Key("password").String()
    dbName := cfg.Section("database").Key("dbname").String()

    // 获取 server 段
    srvAddr := cfg.Section("server").Key("addr").String()
    timeout, _ := cfg.Section("server").Key("timeout").Int64()
    enableGzip, _ := cfg.Section("server").Key("enable_gzip").Bool()

    fmt.Printf("数据库: %s@%s:%d/%s\n", dbUser, dbHost, dbPort, dbName)
    fmt.Printf("服务地址: %s, 超时: %ds, Gzip: %v\n", srvAddr, timeout, enableGzip)
}

支持结构体映射的高级用法

go-ini 支持将配置直接映射到结构体，提升可维护性：

type DatabaseConfig struct {
    Host     string `ini:"host"`
    Port     int    `ini:"port"`
    User     string `ini:"user"`
    Password string `ini:"password"`
    DBName   string `ini:"dbname"`
}

type ServerConfig struct {
    Addr      string `ini:"addr"`
    Timeout   int64  `ini:"timeout"`
    EnableGzip bool  `ini:"enable_gzip"`
}

type AppConfig struct {
    Database DatabaseConfig `ini:"database"`
    Server   ServerConfig   `ini:"server"`
}

func main() {
    var appConfig AppConfig

    err := ini.MapTo(&appConfig, "config.ini")
    if err != nil {
        log.Fatal("映射配置失败:", err)
    }

    fmt.Printf("数据库主机: %s\n", appConfig.Database.Host)
    fmt.Printf("服务端口: %s\n", appConfig.Server.Addr)
}

这种方式让配置管理更整洁，适合大型项目。

处理默认值与可选字段

可以通过设置默认值避免程序因缺失配置而崩溃：

// 读取带默认值的字段
timeout := cfg.Section("server").Key("timeout").MustInt(60)
logLevel := cfg.Section("server").Key("log_level").MustString("info")

Must* 系列方法允许指定默认值，增强健壮性。

基本上就这些。使用 go-ini 库能快速实现配置读取、结构体绑定和默认值管理，是Golang中处理INI文件的成熟方案。注意确保配置文件路径正确，并在生产环境中做好权限控制。不复杂但容易忽略。

今天关于《Golang读取INI配置文件教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！

前往漫画官网入口并下载 ➜

golang INI配置