在Go語言中，項目工程化的日志、配置、錯誤處理規范是保障項目可維護性、可觀測性與健壯性的核心實踐之一。本章將從三個方面進行詳解：

---

一、日志規范

1. 日志的重要性

• ? 問題排查的唯一“現場還原”
• ? 性能瓶頸的定位手段
• ? 安全審計的依據

2. 日志庫推薦

• ? 標準庫?log：適合簡單應用
• ? 社區常用庫：
  • ??uber-go/zap：高性能，結構化日志（強烈推薦）
  • ??sirupsen/logrus：API 友好，易上手

3. zap日志初始化示例

import?"go.uber.org/zap"var?Logger?*zap.Loggerfunc?InitLogger()?{var?err?errorLogger,?err?=?zap.NewProduction()?//?生產級配置if?err?!=?nil?{panic(err)}
}

4. 日志級別推薦使用

• ??Debug: 調試信息
• ??Info: 關鍵運行信息，如啟動、配置、輸入參數等
• ??Warn: 潛在問題，如配置異常、響應慢
• ??Error: 明確錯誤，需排查
• ??Fatal: 致命錯誤，程序將退出

5. 使用結構化日志推薦

Logger.Info("user?login?success",zap.String("username",?username),zap.Int("user_id",?userID),
)

---

二、配置規范

1. 配置分離的必要性

• ? 保證代碼不依賴具體運行環境
• ? 配置可以熱更新或動態下發

2. 常見配置方式

類型	示例	說明
JSON	config.json	可讀性強
YAML	config.yaml	層級清晰，易維護
環境變量	os.Getenv("ENV")	容器部署推薦
TOML	用于更復雜配置，如數據庫等	文檔友好

3. viper 讀取配置示例

import?"github.com/spf13/viper"func?InitConfig()?{viper.SetConfigName("config")viper.SetConfigType("yaml")viper.AddConfigPath(".")if?err?:=?viper.ReadInConfig();?err?!=?nil?{panic(fmt.Errorf("fatal?config?error:?%w",?err))}
}

配置樣例?config.yaml：

app:port:?8080env:?devdb:dsn:?"root:pass@tcp(127.0.0.1:3306)/demo"

4. 支持多環境配置

通過環境變量加載不同配置文件：

env?:=?os.Getenv("APP_ENV")?//?dev?/?prod
viper.SetConfigName("config."?+?env)

---

三、錯誤處理規范

1. Go 的錯誤處理哲學

Go 不鼓勵異常（try-catch），采用?顯式返回 error，更清晰、穩定。

2. 標準寫法

result,?err?:=?doSomething()
if?err?!=?nil?{log.Error("doSomething?failed",?zap.Error(err))return?err
}

3. 自定義錯誤類型

type?BizError?struct?{Code????intMessage?string
}func?(e?BizError)?Error()?string?{return?fmt.Sprintf("Code:?%d,?Msg:?%s",?e.Code,?e.Message)
}

4. 錯誤封裝與堆棧追蹤

推薦使用?pkg/errors?或 Go 1.13+ 原生?errors?包：

import?"errors"func?WrapError()?error?{err?:=?do()return?fmt.Errorf("業務處理失敗:?%w",?err)
}

調用鏈尾部使用?errors.Unwrap(err)?或?errors.Is/As?判斷原始錯誤類型。

5. 錯誤分層處理建議

層	錯誤類型	建議
Handler	參數、用戶態錯誤	返回給前端，記錄 info
Service	業務邏輯錯誤	返回調用方，記錄 warn
Repo/DAO	數據庫錯誤、IO 錯誤	封裝后返回，記錄 error
Main入口	崩潰、配置錯誤	panic or fatal log

---

四、實踐統一封裝建議

1. 錯誤響應體封裝（HTTP）

type?APIError?struct?{Code????int????`json:"code"`Message?string?`json:"message"`
}

2. 自定義全局日志器/配置/錯誤包

project/
├──?pkg/
│???├──?logger/
│???├──?config/
│???└──?errors/

pkg/logger/logger.go:

var?Logger?*zap.Loggerfunc?Init(logPath?string)?{//?初始化日志
}

---

五、總結

模塊	工程化建議
日志	使用 zap，結構化輸出，統一封裝，支持級別/文件分割等
配置	使用 viper/yaml，支持環境變量，模塊分離
錯誤	明確分層處理，業務錯誤自定義結構體，推薦使用 fmt.Errorf + %w 方式

---