Go（Golang）是一種高效、簡潔的編程語言，特別適合Web開發。以下是詳細的Go Web開發指南，涵蓋從基礎到進階的內容。
---
一、Go Web開發基礎
?1. 標準庫 `net/http`
Go 內置 `net/http` 包，支持快速構建 Web 服務。
- 基本示例：
? ```go
? package main? import (
? ? ? "fmt"
? ? ? "net/http"
? )? func handler(w http.ResponseWriter, r *http.Request) {
? ? ? fmt.Fprintf(w, "Hello, Go Web!")
? }? func main() {
? ? ? http.HandleFunc("/", handler) // 注冊路由
? ? ? http.ListenAndServe(":8080", nil) // 啟動服務器
? }
??
- 請求處理：通過 `r.Method` 獲取請求方法，`r.URL` 解析路徑和參數。
- 響應寫入：使用 `http.ResponseWriter` 寫入內容，支持文本、JSON、文件等。
?2. 路由與參數
- 動態路由：使用正則或第三方庫（如 `gorilla/mux`）處理路徑參數。
? ```go
? import (
? ? ? "github.com/gorilla/mux"
? )? func main() {
? ? ? r := mux.NewRouter()
? ? ? r.HandleFunc("/user/{id}", userHandler)
? ? ? http.ListenAndServe(":8080", r)
? }? func userHandler(w http.ResponseWriter, r *http.Request) {
? ? ? vars := mux.Vars(r)
? ? ? id := vars["id"]
? ? ? fmt.Fprintf(w, "User ID: %s", id)
? }
? ```
二、常用 Web 框架
?1. Gin
- 特點：高性能、簡潔語法，支持中間件、路由分組。
- 示例：
? ```go
? import (
? ? ? "github.com/gin-gonic/gin"
? )? func main() {
? ? ? r := gin.Default() // 默認包含日志和恢復中間件
? ? ? r.GET("/ping", func(c *gin.Context) {
? ? ? ? ? c.JSON(200, gin.H{"message": "pong"})
? ? ? })
? ? ? r.Run(":8080")
? }
2. Echo
- 特點：極簡設計，高性能，支持中間件和模板渲染。
- 示例：
? ```go
? import (
? ? ? "github.com/labstack/echo/v4"
? ? ? "net/http"
? )? func main() {
? ? ? e := echo.New()
? ? ? e.GET("/", func(c echo.Context) error {
? ? ? ? ? return c.String(http.StatusOK, "Hello Echo!")
? ? ? })
? ? ? e.Start(":8080")
? }
? ```
?3. Beego
- 特點：功能豐富，支持 MVC、ORM、Session 等。
- 適用場景：大型項目或需要快速原型開發。
---
三、數據庫操作
?1. 使用 GORM（對象關系映射）
- 連接數據庫：
? ```go
? import (
? ? ? "gorm.io/driver/mysql"
? ? ? "gorm.io/gorm"
? )? func main() {
? ? ? dsn := "user:password@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
? ? ? db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
? ? ? if err != nil {panic(err)}? ? ? // 自動遷移表結構
? ? ? db.AutoMigrate(&User{})
? }
??
- 定義模型：
? ```go
? type User struct {
? ? ? ID ? ? ? ?uint ? `gorm:"primaryKey"`
? ? ? Name ? ? ?string `gorm:"size:255"`
? ? ? Email ? ? string `gorm:"unique"`
? ? ? CreatedAt time.Time
? }
??
- CRUD 操作：
? ```go
? // 創建
? db.Create(&User{Name: "Alice", Email: "alice@example.com"})? // 查詢
? var user User
? db.First(&user, "email = ?", "alice@example.com")? // 更新
? db.Model(&user).Update("Name", "Bob")? // 刪除
? db.Delete(&user)
? ```
---
四、中間件
1. Gin 中間件示例
- 日志中間件：
? ```go
? r := gin.New() // 不包含默認中間件
? r.Use(gin.Logger()) // 添加日志中間件
? r.Use(gin.Recovery()) // 添加異常恢復中間件
? ```
- **自定義中間件**：
? ```go
? r.Use(func(c *gin.Context) {
? ? ? // 前置處理
? ? ? fmt.Println("Request ID:", c.GetString("id"))
? ? ? c.Next() // 繼續處理請求
? ? ? // 后置處理
? ? ? fmt.Println("Response Status:", c.Writer.Status())
? })
---
五、API 開發
1. RESTful API 設計
- 規范：使用 HTTP 方法（GET/POST/PUT/DELETE）對應資源操作。
- 示例：
? ```go
? r.GET("/users", getUsers) ? ? ? // 獲取用戶列表
? r.POST("/users", createUser) ? ?// 創建用戶
? r.GET("/users/:id", getUser) ? ?// 獲取單個用戶
? r.PUT("/users/:id", updateUser) // 更新用戶
? r.DELETE("/users/:id", deleteUser) // 刪除用戶
??
?
2. JSON 處理
- 解析請求：
? ```go
? type User struct {
? ? ? Name ?string `json:"name"`
? ? ? Email string `json:"email"`
? }? func createUser(c *gin.Context) {
? ? ? var user User
? ? ? if err := c.ShouldBindJSON(&user); err != nil {
? ? ? ? ? c.JSON(400, gin.H{"error": err.Error()})
? ? ? ? ? return
? ? ? }
? ? ? // 保存到數據庫...
? ? ? c.JSON(201, user)
? }
? ```
- **生成響應**：
? ```go
? c.JSON(200, gin.H{
? ? ? "status": "success",
? ? ? "data": ? user,
? })
??
?
?3. Swagger 文檔
- 使用 `swaggo/swag`：通過注釋生成 API 文檔。
? ```go
? // @Summary Get User
? // @Param id path int true "User ID"
? // @Success 200 {object} User
? func getUser(c *gin.Context) { /* ... */ }
---
六、部署與運維
?1. Linux 部署
- 編譯：`GOOS=linux GOARCH=amd64 go build -o app main.go`
- 運行：`./app -env=prod`（通過環境變量配置）
- Supervisor/Systemd：配置后臺運行和自動重啟。
2. Nginx 反向代理
- 配置示例：
? ```nginx
? server {
? ? ? listen 80;
? ? ? server_name example.com;? ? ? location / {
? ? ? ? ? proxy_pass http://127.0.0.1:8080;
? ? ? ? ? proxy_set_header Host $host;
? ? ? ? ? proxy_set_header X-Real-IP $remote_addr;
? ? ? }
? }
??
?
?3. Docker 化
- Dockerfile：
? ```dockerfile
? FROM golang:1.20-alpine AS builder
? WORKDIR /app
? COPY . .
? RUN go build -o main .? FROM alpine:latest
? COPY --from=builder /app/main /main
? CMD ["/main"]
??
- 構建與運行：
? ```bash
? docker build -t go-web-app .
? docker run -d -p 8080:8080 go-web-app
??
---
七、性能優化
?1. 并發處理
- Goroutine：利用 `go` 關鍵字處理并發任務。
? ```go
? go func() {
? ? ? time.Sleep(2 * time.Second)
? ? ? fmt.Println("Task done")
? }()
??
- Channel：用于協程間通信。
- Worker Pool：限制并發數，避免資源耗盡。
2. 連接池
- 數據庫連接池：配置 `gorm` 或 `database/sql` 的最大連接數。
- HTTP Client Pool：復用 HTTP 客戶端，減少連接延遲。
3. 靜態資源優化
- 壓縮與緩存：啟用 Gzip，設置 `Cache-Control` 頭。
- CDN 加速：將靜態文件托管到 CDN（如阿里云 OSS）。
---
八、測試與調試
?1. 單元測試
- 使用 `testing` 包：
? ```go
? func TestAdd(t *testing.T) {
? ? ? if result := Add(1, 2); result != 3 {
? ? ? ? ? t.Errorf("Expected 3, got %d", result)
? ? ? }
? }
?
- Mock 測試：模擬數據庫或外部 API。
?2. 調試工具
- 日志打印：使用 `log` 或第三方庫（如 `logrus`）。
- pprof 性能分析：生成 CPU/內存 profile。
- Delve：Go 專用調試器，支持斷點、變量查看。
---
九、最佳實踐
1. 錯誤處理：統一錯誤響應格式，避免泄露敏感信息。
2. 安全性：防止 SQL 注入、XSS，使用 HTTPS。
3. 配置管理：使用環境變量或配置文件（如 `viper`）。
4. 日志分級：區分開發、生產環境的日志級別。
5. 依賴管理：使用 `go mod`，定期更新依賴。
?
