gopkg.in/ini.v1不适合解析.properties文件，因其专为带[section]的INI格式设计，无法正确处理无节的纯key=value结构、#行尾注释、空格键名、反斜杠转义及Unicode转义等Java properties规范特性。
Go 原生不支持 .properties 文件解析，必须借助第三方库或手动实现；直接用 gopkg.in/ini.v1 会出错——它只认 [section]，而 .properties 是纯 key=value 扁平结构，没有节概念。
为什么 gopkg.in/ini.v1 不适合 .properties
gopkg.in/ini.v1 设计目标是兼容 INI 风格（带节头），对 host=127.0.0.1 这类无节配置默认归入空节 ""，但 cfg.Section("").Keys() 行为不稳定，且无法处理带空格的 key（如 app name = myapp）或反斜杠转义（path=C:\temp）。更关键的是：它不识别 # 开头的行尾注释（port=8080 # dev port 会被当值的一部分）。
- 错误现象：
cfg.Section("").Key("port").Value()返回空字符串，但文件里明明写了port=8080 - 根本原因：未调用
ini.LoadSources(ini.LoadOptions{AllowBooleanKeys: true, AllowShadows: true})，且没禁用节自动推导 - 替代方案：要么换库，要么手写简单 parser —— 对纯
.properties，后者几行代码就能搞定
用 go-ini/ini 解析时必须显式配置选项
如果坚持用 go-ini/ini（注意不是 gopkg.in/ini.v1），需强制关闭节解析、启用键值对直读模式：
cfg, err := ini.LoadSources(ini.LoadOptions{
Loose: true,
IgnoreInlineComment: false,
AllowPythonMultilineValues: false,
AllowNonUniqueSections: false,
}, "config.properties")
if err != nil {
log.Fatal(err)
}
// 必须读空节，且 Key() 要用原始 key 名（区分大小写）
port := cfg.Section("").Key("port").Value()
-
Loose: true允许无节内容；IgnoreInlineComment: false才能识别#行尾注释 - key 名严格匹配，
Port和port是两个键；若需忽略大小写，得自己strings.ToLower()预处理 - 不支持 Unicode 转义（
useru003Dadmin不会被解码），也不处理反斜杠路径（log.dir=C:\app\logs中的\会原样保留）
手写轻量 parser 更可控（推荐）
对标准 Java-style .properties（key=value、# 注释、 转义），15 行内可写出稳定 parser，比引入库更少依赖、更易调试：
立即学习“go语言免费学习笔记（深入）”；
func ParseProperties(path string) (map[string]string, error) {
data, err := os.ReadFile(path)
if err != nil {
return nil, err
}
m := make(map[string]string)
for _, line := range strings.Split(string(data), "
") {
line = strings.TrimSpace(line)
if line == "" || strings.HasPrefix(line, "#") || strings.HasPrefix(line, "!") {
continue
}
if idx := strings.Index(line, "="); idx > 0 {
k := strings.TrimSpace(line[:idx])
v := strings.TrimSpace(line[idx+1:])
// 简单去反斜杠转义（仅
\）
v = strings.ReplaceAll(v, "\n", "
")
v = strings.ReplaceAll(v, "\t", " ")
v = strings.ReplaceAll(v, "\r", "
")
v = strings.ReplaceAll(v, "\\", "\")
m[k] = v
}
}
return m, nil
}
- 跳过空行、
#和!开头的注释行（Java 规范支持两种注释符） - 只按第一个
=切分，避免url=http://a=b&c=d被误切 - 转义处理仅覆盖常见情况；若需完整支持（如
u0041），应改用strconv.Unquote+ 预加双引号 - 返回
map[string]string，后续用strconv.Atoi、strconv.ParseBool显式转换，类型安全由你控制
环境变量 fallback 与类型转换要自己补全
.properties 没有类型语义，所有值都是字符串。不能指望解析器自动转 port=8080 成 int，也不能靠 viper.Get("port") 自动断言——viper 对 .properties 支持极弱，且不校验字段存在性。
- 关键字段缺失时，
map["port"]返回空字符串，必须手动检查：if portStr == "" { return errors.New("port is required") } - 环境变量优先级高于 properties？那就先
os.Getenv("APP_PORT")，为空再查 map - 不要封装
GetInt("port")方法——它掩盖了缺失和格式错误，panic 风险高；统一用GetInt(key string, def int) int提供默认值更稳妥 - 真正需要“动态”行为（如灰度开关）时，直接用
map[string]string+sync.RWMutex包一层，比任何泛型接口都快且安全
最常被忽略的一点：Java properties 规范要求 key 和 value 的 leading/trailing 空格默认被 trim，但等号前的空格属于 key，等号后的属于 value——手写 parser 时若用 strings.SplitN(line, "=", 2) 再整体 TrimSpace，会错误合并空格。必须按规范逐字符扫描，或用正则 ^([^=]*?)s*=s*(.*)$ 捕获。
