Go 的 http 包默认不自动提供静态文件，需显式配置 http.FileServer 并结合 http.StripPrefix 将 URL 路径映射到本地目录，才能通过 /assets/js/app.js 等路径访问前端资源。
go 的 `http` 包默认不自动提供静态文件，需显式配置 `http.fileserver` 并结合 `http.stripprefix` 将 url 路径映射到本地目录，才能通过 `/assets/js/app.js` 等路径访问前端资源。
在 Go 中构建轻量 Web 服务时，一个常见误区是认为 HTML 文件能“自动”加载同目录或相对路径下的 JS/CSS——实际上，浏览器发起的每个资源请求（如 <script src="/js/app.js"></script>）都会向服务器发送独立的 HTTP 请求，而 Go 的 http.ServeFile 或自定义 handler 仅响应特定路由（如 /），不会自动处理 /js/、/css/ 等路径。因此，必须显式注册静态文件服务。
✅ 正确做法：使用 http.FileServer + http.StripPrefix
推荐将静态资源（JS、CSS、图片等）统一放在 assets/ 目录下，并通过 /assets/ 前缀暴露：
├── assets/ │ ├── js/ │ │ └── app.js │ └── css/ │ └── style.css ├── templates/ │ └── index.html └── main.go
在 main.go 中配置：
package main
import (
"net/http"
)
func main() {
// 处理首页（HTML）
http.HandleFunc("/", rootHandler)
// 处理静态资源：/assets/xxx → 映射到 assets/ 目录
http.Handle("/assets/", http.StripPrefix("/assets/", http.FileServer(http.Dir("assets"))))
println("Server starting on :8080")
http.ListenAndServe(":8080", nil)
}
func rootHandler(w http.ResponseWriter, r *http.Request) {
http.ServeFile(w, r, "templates/index.html")
}对应 HTML 中引用方式为：
立即学习“前端免费学习笔记（深入）”；
<!-- templates/index.html --> <script src="/assets/js/app.js"></script> <link rel="stylesheet" href="/assets/css/style.css"> <img src="/assets/images/logo.png" alt="Logo">
⚠️ 关键要点说明
-
http.FileServer(http.Dir("assets"))创建一个服务，将请求路径直接映射到assets/下的文件系统路径； -
http.StripPrefix("/assets/", ...)移除请求 URL 中的/assets/前缀，否则http.FileServer会尝试查找assets/assets/js/app.js（导致 404）； - 路由顺序无关紧要（
http.Handle和http.HandleFunc注册无执行顺序依赖），但路径匹配遵循最长前缀优先原则，因此/assets/不会干扰/； - 静态资源路径必须以
/开头（绝对路径），如<script src="/assets/js/app.js"></script>；若写成src="assets/js/app.js"（相对路径），浏览器将基于当前 HTML URL 解析，易因路由嵌套出错（例如访问/user/123时解析为/user/assets/js/app.js）。
? 调试建议
- 启动服务器后，直接在浏览器访问
http://localhost:8080/assets/js/app.js，确认是否返回 JS 内容及状态码200； - 检查浏览器开发者工具（Network 标签页），查看
.js请求是否返回404，并核对 Request URL 是否与http.Handle注册的前缀一致； - 确保
assets/目录与main.go位于同一级，或调整http.Dir("...")中的相对路径。
通过以上配置，Go 服务器即可安全、高效地提供静态资源，无需额外框架，兼顾简洁性与生产可用性。
