快捷導(dǎo)航

Go標(biāo)準(zhǔn)庫net/http包的實現(xiàn)

更新時間：2026年03月16日 10:08:11 作者：我叫黑大帥

net/http是Go官方自帶的 HTTP 框架,不用裝任何第三方庫,本文就來詳細(xì)的介紹一下Go標(biāo)準(zhǔn)庫net/http包的實現(xiàn),感興趣的可以了解一下

服務(wù)端

核心 API

http.HandleFunc(pattern, handler): 注冊路由（將路徑和對應(yīng)的函數(shù)綁定）。
http.ListenAndServe(addr, handler): 啟動監(jiān)聽并服務(wù)?！付嗫蛻舳诉B接不阻塞」的核心！
http.ResponseWriter: 用于向客戶端寫入響應(yīng)（寫回數(shù)據(jù)）。
*http.Request: 包含客戶端發(fā)來的所有信息（URL、Header、參數(shù)等）。

package main

import (
	"fmt"
	"net/http"
)

func helloHandler(w http.ResponseWriter, r *http.Request) {
	// r.Method 可以判斷是 GET 還是 POST
	fmt.Fprintf(w, "你好，你訪問的路徑是: %s", r.URL.Path)
}

func main() {
	// 1. 路由注冊
	http.HandleFunc("/", helloHandler)

	// 2. 啟動服務(wù)，監(jiān)聽 8080 端口
	fmt.Println("服務(wù)器啟動在 http://localhost:8080")
	err := http.ListenAndServe(":8080", nil)
	if err != nil {
		panic(err)
	}
}

HandleFunc與接口函數(shù)

// `net/http` 定義了一個接口
type Handler interface {
    ServeHTTP(w http.ResponseWriter, r *http.Request)
}


func(w http.ResponseWriter, r *http.Request)

`w http.ResponseWriter` 給客戶端返回數(shù)據(jù)（寫響應(yīng)）

w.Write([]byte("返回內(nèi)容"))
w.WriteHeader(404) // 設(shè)置狀態(tài)碼
fmt.Fprintln(w, "hello") // 也可以這樣寫

`r *http.Request` 獲取客戶端傳過來的東西

URL 參數(shù)
POST 表單 / JSON
請求頭
請求方法（GET/POST）

常用的 5 種HandleFunc用法

處理 GET 請求（獲取 URL 參數(shù)）

http.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
	// 獲取 ?name=xxx & age=xxx
	name := r.URL.Query().Get("name")
	age := r.URL.Query().Get("age")

	w.Write([]byte("名字：" + name + " 年齡：" + age))
})

處理 POST 表單（前端提交數(shù)據(jù)）

http.HandleFunc("/login", func(w http.ResponseWriter, r *http.Request) {
	// 解析 POST 表單
	r.ParseForm()

	// 獲取表單參數(shù)
	username := r.PostForm.Get("username")
	password := r.PostForm.Get("password")

	w.Write([]byte("用戶名：" + username + " 密碼：" + password))
})

返回 JSON（寫 API 接口）

type User struct {
	Name string `json:"name"`
	Age  int    `json:"age"`
}

http.HandleFunc("/json", func(w http.ResponseWriter, r *http.Request) {
	user := User{Name: "張三", Age: 20}

	// 設(shè)置返回格式 JSON
	w.Header().Set("Content-Type", "application/json")

	// 編碼并返回
	json.NewEncoder(w).Encode(user)
})

路由分組 / 多個接口

// 首頁
http.HandleFunc("/", homeHandler)

// 用戶相關(guān)
http.HandleFunc("/user/list", userListHandler)
http.HandleFunc("/user/info", userInfoHandler)

// 登錄
http.HandleFunc("/login", loginHandler)

訪問靜態(tài)文件服務(wù)

// 訪問 /static/ 下的文件 
http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("static"))))

ServeMux 與自定義 Handler

mux := http.NewServeMux()
mux.HandleFunc("/user", userHandler)
// 將 mux 傳入 ListenAndServe
http.ListenAndServe(":8080", mux)

直接使用 http.HandleFunc (默認(rèn)模式)

當(dāng)你直接調(diào)用 http.HandleFunc 時，Go 會在后臺使用一個全局默認(rèn)的實例，叫 DefaultServeMux。

優(yōu)點：代碼少，寫個小腳本測試非?？?。
缺點：它是全局共享的。如果你引入的第三方庫也偷偷在 DefaultServeMux 上注冊了路由，可能會產(chǎn)生沖突。此外，在單元測試中，全局變量會讓測試變得互相干擾。

使用 http.NewServeMux() (自定義模式)

當(dāng)你創(chuàng)建自己的 mux 時，你是在創(chuàng)建一個隔離的路由表。

優(yōu)點：更安全、更靈活。你可以創(chuàng)建多個 mux，分別跑在不同的端口上，或者在測試時輕松地替換它。

package main

import (
	"fmt"
	"net/http"
)

func main() {
	// --- 局部變量 1：給普通用戶的路由 ---
	userMux := http.NewServeMux()
	userMux.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprint(w, "這是【普通用戶】的個人中心")
	})

	// --- 局部變量 2：給管理員的路由 ---
	adminMux := http.NewServeMux()
	adminMux.HandleFunc("/user", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprint(w, "這是【管理員】的用戶管理界面")
	})

	// 在 8080 端口啟動用戶服務(wù)
	go http.ListenAndServe(":8080", userMux)

	// 在 9090 端口啟動管理服務(wù)
	fmt.Println("服務(wù)已啟動：8080 為用戶，9090 為管理")
	http.ListenAndServe(":9090", adminMux)
}

客戶端

常用 API

http.Get(url): 發(fā)送簡單的 GET 請求。
http.Post(url, contentType, body): 發(fā)送 POST 請求。
http.Client: 如果需要設(shè)置超時、Header 等高級操作，需要自定義 Client。

resp, err := http.Get("https://api.github.com")
if err != nil {
    log.Fatal(err)
}
// 記得關(guān)閉 Body，防止內(nèi)存泄漏
defer resp.Body.Close()

// 讀取響應(yīng)內(nèi)容
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))

到此這篇關(guān)于Go標(biāo)準(zhǔn)庫net/http包的實現(xiàn)的文章就介紹到這了,更多相關(guān)Go標(biāo)準(zhǔn)庫net/http包內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: