Go通过net/http提供HTTP服务与html/template渲染HTML，浏览器负责加载页面；需预加载模板、正确设置Content-Type、用FileServer暴露静态资源，并区分HTML页面与JSON接口。
go 本身不“加载 web 页面”，它只提供 http 服务和模板渲染能力；真正加载页面的是浏览器。你实际要解决的，是让 go 启动一个能返回 html 的 web 服务，并支持静态资源、模板、路由这些基础能力。
启动 HTTP 服务器并注册根路由
用 net/http 最简方式跑起来：
package main
import (
"fmt"
"net/http"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprint(w, "<h1>Hello from Go</h1>")
})
fmt.Println("Server starting on :8080")
http.ListenAndServe(":8080", nil)
}
注意：http.ListenAndServe 会阻塞主线程，后续代码不会执行；端口被占用时默认 panic，建议加错误处理：
- 检查错误：用
err := http.ListenAndServe(...)+if err != http.ErrServerClosed { log.Fatal(err) } - 避免硬编码端口：从
os.Getenv("PORT")读取，适配 Docker/K8s - 别在 handler 里写死 HTML 字符串——适合原型，不适合维护
加载 HTML 模板（不是“加载页面”，而是生成响应）
Go 的 html/template 不是浏览器端的“动态加载”，而是在服务端把数据注入模板后，一次性吐出完整 HTML 给浏览器。
必须在启动时预加载并解析，否则每次请求都 Parse() 会严重拖慢性能：
立即学习“go语言免费学习笔记（深入）”；
var indexTpl = template.Must(template.ParseFiles("./templates/index.html"))
func indexHandler(w http.ResponseWriter, r *http.Request) {
if err := indexTpl.Execute(w, map[string]interface{}{"Title": "Home"}); err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
}
常见坑：
-
template.Must()在解析失败时直接 panic，生产环境建议自己捕获错误并日志记录 - 相对路径如
"./templates/..."依赖当前工作目录，CI/CD 或 Docker 中易失效；推荐用os.Executable()+filepath.Dir()构造绝对路径 - 模板文件修改后需重启程序——开发阶段可加 fsnotify 热重载，但生产环境禁止
提供静态文件（CSS/JS/图片）
浏览器加载页面时，会自动发起对 /static/main.css 这类路径的请求。Go 需显式暴露静态目录：
fs := http.FileServer(http.Dir("./static"))
http.Handle("/static/", http.StripPrefix("/static/", fs))
关键点：
-
http.StripPrefix必须带结尾斜杠"/static/"，否则请求/static/css/app.css会被映射成./static/css/app.css（正确），而不是./staticcss/app.css（错误） - 静态文件路径要在 HTML 中显式写对，比如
<link rel="stylesheet" href="/static/main.css"> - 不要用
http.ServeFile做目录服务——它不支持索引页，且无法统一加缓存头
区分“加载页面”和“异步加载数据”
前端用 fetch("/api/users") 加载 JSON 是另一回事。Go 只需提供轻量 API：
type User struct {
ID int `json:"id"`
Name string `json:"name"`
}
http.HandleFunc("/api/users", func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode([]User{{ID: 1, Name: "Alice"}})
})
这里没有模板、不返回 HTML，纯数据接口。重点是：
- 设好
Content-Type，否则前端response.json()可能失败 - 别在每个 handler 里重复写 header 设置——用中间件或封装函数统一处理
- 如果并发高，确保数据库查询、JSON 编码不成为瓶颈；必要时加缓存（如
bigcache）
真正的“页面加载”行为完全由浏览器控制，Go 只负责按需返回 HTML 或 JSON。混淆这两者，容易在架构设计上走偏——比如试图用 Go 去模拟浏览器渲染，那已经不是 Web 服务，而是 SSR 框架范畴了。
