Go语言在Web开发领域中被广泛使用，一个重要原因就是标准库提供了完整而克制的HTTP能力。net/http包既可以作为服务端开发的基础，直接监听端口、解析请求、写入响应，也可以作为客户端工具，发送GET、POST等常见HTTP请求。对于初学者来说，掌握这个包的正确导入方式、服务端写法、客户端调用方式以及生产环境中的注意事项，是进入Go语言网络编程的第一步。
net/http包的正确导入方式
net/http属于Go语言标准库，不需要通过第三方依赖管理工具额外安装，也不需要在项目依赖文件中单独声明。只要本地安装了Go语言环境，就可以在源码中直接导入使用。导入时需要特别注意导入路径必须准确无误，标准写法是固定路径net/http，不能随意更改大小写，也不能自行添加版本号或子路径。
package main
import "net/http"
func main() {
// 通过引用标准库中的默认路由器，确认 net/http 已成功导入
_ = http.DefaultServeMux
}
在实际项目中，通常会同时导入多个标准库，例如格式化输入输出、日志、时间处理等。这种情况下可以使用括号进行组合导入，使代码结构更加清晰，也便于后续维护和格式化。
package main
import (
"fmt"
"net/http"
)
func main() {
// 组合导入多个标准库时，通常使用括号统一组织
fmt.Println("net/http package imported")
_ = http.DefaultServeMux
}
常见的错误写法包括把路径写成net/HTTP、net/http/v2，或者误以为需要像第三方包一样先执行安装命令。Go语言的导入路径区分大小写，标准库目录也是固定的，因此这些错误路径都会导致编译失败。另外，在Go modules项目中，标准库包不需要写入依赖文件，直接导入即可被编译器识别。
基于net/http搭建HTTP服务端
基础服务端实现
net/http包的服务端能力围绕请求与响应展开。服务端程序通常需要完成三件事：监听端口、匹配请求路径、执行处理函数并返回响应。包内提供了非常直接的函数来完成这些工作，其中http.HandleFunc用于注册路径和处理函数，http.ListenAndServe用于启动服务并持续监听客户端请求。
下面是一个最基础的服务端示例。当客户端访问根路径时，服务端会返回一段纯文本响应。处理函数中的http.ResponseWriter用于写出响应内容，http.Request则包含请求方法、请求路径、请求头等信息。
package main
import (
"fmt"
"net/http"
)
// helloHandler 处理根路径请求
func helloHandler(w http.ResponseWriter, r *http.Request) {
// 设置响应头，告诉客户端返回的是纯文本
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
// 写入响应正文
fmt.Fprintf(w, "Hello, this is a response from net/http server")
}
func main() {
// 注册根路径处理函数
http.HandleFunc("/", helloHandler)
fmt.Println("Server start at :8080")
// 启动 HTTP 服务，监听本机 8080 端口
err := http.ListenAndServe(":8080", nil)
if err != nil {
fmt.Printf("Server start failed: %vn", err)
}
}
路由注册与匹配规则
除了根路径之外，服务端通常还需要处理多个不同路径。例如用户接口、订单接口、静态资源接口等。net/http的默认路由器支持注册固定路径，也支持通过以斜杠结尾的路径处理一组子路径请求。理解路径注册方式，有助于更好地组织服务端接口。
package main
import (
"fmt"
"net/http"
)
func main() {
// 精确匹配 /api/user
http.HandleFunc("/api/user", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "This is user api response")
})
// 精确匹配 /api/order
http.HandleFunc("/api/order", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "This is order api response")
})
// 以斜杠结尾的路径会匹配该前缀下的多个请求
http.HandleFunc("/static/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Static resource path: %s", r.URL.Path)
})
fmt.Println("Server start at :8080")
err := http.ListenAndServe(":8080", nil)
if err != nil {
fmt.Printf("Server start failed: %vn", err)
}
}
在上述示例中，访问/api/user会进入用户接口处理逻辑，访问/api/order会进入订单接口处理逻辑，而访问以/static/开头的路径时会进入同一个处理函数。这种路由方式虽然简单，但对于小型服务、内部工具、演示项目已经足够。如果项目规模继续增长，也可以在此基础上封装自己的路由逻辑，或者使用更成熟的第三方路由组件。
使用net/http发送HTTP客户端请求
发送GET请求
net/http包不仅能编写服务端，也能作为客户端发起HTTP请求。对于简单的GET请求，可以直接使用http.Get函数。该函数会返回响应对象和可能发生的错误。拿到响应后，通常需要读取响应体，并在函数退出前关闭响应体，以避免网络连接资源泄漏。
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
// 发送 GET 请求
resp, err := http.Get("http://127.0.0.1:8080/")
if err != nil {
fmt.Printf("Request failed: %vn", err)
return
}
// 请求结束后必须关闭响应体
defer resp.Body.Close()
// 读取响应正文
body, err := io.ReadAll(resp.Body)
if err != nil {
fmt.Printf("Read response failed: %vn", err)
return
}
fmt.Printf("Response status: %sn", resp.Status)
fmt.Printf("Response body: %sn", body)
}
发送POST请求
发送POST请求时，可以使用http.Post函数。它需要指定目标地址、请求内容类型以及请求体。常见的表单提交会使用application/x-www-form-urlencoded类型，请求体则是键值对形式的字符串。下面示例向本地服务的用户接口提交一组简单表单数据。
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
// 以表单形式发送 POST 请求
resp, err := http.Post(
"http://127.0.0.1:8080/api/user",
"application/x-www-form-urlencoded",
strings.NewReader("name=test&age=18"),
)
if err != nil {
fmt.Printf("Request failed: %vn", err)
return
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
fmt.Printf("Read response failed: %vn", err)
return
}
fmt.Printf("Response status: %sn", resp.Status)
fmt.Printf("Response body: %sn", body)
}
如果请求需要携带自定义请求头、设置超时时间、使用不同的HTTP方法，或者提交JSON数据，可以在掌握基础用法后进一步使用http.NewRequest和http.Client。不过从学习路径来看，先熟悉http.Get与http.Post，再逐步理解更灵活的客户端配置，是比较自然的进阶方式。
常见注意事项与生产环境建议
在学习阶段，直接使用默认配置可以快速启动服务；但在生产环境中，默认配置往往不够严谨。HTTP服务可能面对慢速连接、异常客户端、突发流量等情况，因此需要更明确地控制超时时间、资源释放和错误处理。自定义http.Server结构体是常见的改进方式。
- 服务端启动后通常会持续阻塞运行，直到程序被终止或监听过程发生错误。
- 客户端收到响应后，必须关闭
resp.Body，否则可能导致连接资源无法及时释放。 - 获取GET参数时，可以使用
r.URL.Query()；获取POST表单参数时，通常需要先调用r.ParseForm()，再读取表单值。 - 服务端应设置合理的读取超时、写入超时和空闲超时，避免连接被长时间占用。
- 对外提供接口时，应明确设置响应头、状态码和错误信息，方便客户端正确解析结果。
package main
import (
"fmt"
"net/http"
"time"
)
func main() {
// 自定义 HTTP 服务器配置
server := &http.Server{
Addr: ":8080",
ReadTimeout: 5 * time.Second,
WriteTimeout: 10 * time.Second,
IdleTimeout: 15 * time.Second,
}
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Server with custom config")
})
fmt.Println("Custom server start at :8080")
err := server.ListenAndServe()
if err != nil {
fmt.Printf("Server start failed: %vn", err)
}
}
总体来看，net/http包的设计思路非常符合Go语言简洁、直接、组合性强的风格。它没有一开始就引入复杂框架，而是把HTTP服务端和客户端所需的核心能力清晰地暴露出来。开发者可以先用它完成基本功能，再根据项目需要逐步增加超时控制、日志中间件、参数校验、JSON编解码等能力。
在实际开发中，建议先确保导入路径正确，再从一个最小的服务端示例开始，理解请求处理函数的两个核心参数。随后可以练习客户端请求，掌握响应体读取与关闭的基本规范。当项目进入更正式的环境时，再把默认服务器替换为可配置的http.Server，并补充必要的超时与错误处理。按照这个路径学习，能够更扎实地掌握Go语言HTTP开发的基础方法。