css/js返回html内容是因为请求被根路由意外捕获，根本原因是html路径、go路由前缀与文件系统目录三者未对齐；必须用绝对路径引用资源，配合http.stripprefix正确剥离url前缀后映射到本地目录。
为什么 CSS/JS 在 Go 服务里返回 HTML 内容？
这不是文件没找到，而是请求被主路由（比如 http.HandleFunc("/", getHome)）意外捕获了。浏览器发来 /static/style.css 请求，但你没注册对应 handler，Go 就把它交给默认处理器——结果渲染出首页 HTML，状态码还是 200，看着像“加载成功”，实际是假响应。
根本症结就三个没对齐：HTML 中写的路径、Go 注册的路由前缀、本地文件系统目录。只要一个不一致，资源就断链。
- HTML 必须用绝对路径，比如
<link href="/static/css/main.css">，禁用../static/或static/这类相对写法 -
http.Handle()的 pattern（如"/static/"）必须和 HTML 中的路径前缀完全一致（注意结尾斜杠） -
http.Dir("...")里的路径是相对于当前工作目录的，推荐写"./static"而不是"static"，避免部署时因启动位置不同而失效
net/http 里必须用 http.StripPrefix 吗？
必须。只写 http.Handle("/static/", http.FileServer(http.Dir("./static"))) 是错的。
因为 http.FileServer 拿到的请求路径是完整的 /static/css/main.css，它会直接去 ./static/static/css/main.css 找文件——显然不存在。StripPrefix 的作用就是把 /static/ 这段前缀砍掉，剩下 css/main.css，再让 FileServer 去 ./static 下找，这才对得上。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
- StripPrefix 的第一个参数（
"/static/"）必须和http.Handle的 pattern 完全相同，包括开头和结尾的/ - 如果静态文件实际在
./public/css/，那就该写http.Dir("./public")，而不是硬套./static - 顺序上，建议把静态路由注册放在主路由之前，虽然不是强制，但能减少误匹配风险
Gin 框架中 r.Static("asset", "asset") 是怎么映射的？
r.Static("asset", "asset") 表示：当浏览器请求路径以 /asset/ 开头时（比如 /asset/css/app.css），Gin 会从项目根目录下的 asset/ 文件夹里找 css/app.css 并返回。
它等价于 http.Handle("/asset/", http.StripPrefix("/asset/", http.FileServer(http.Dir("./asset"))))，只是 Gin 封装得更简洁。
- 第一个参数
"asset"是 URL 前缀（必须带引号，且不加斜杠），决定浏览器怎么写href；第二个参数"asset"是磁盘路径（相对当前工作目录） - 如果想把
/a/b/c/style.css映射到./asset/css/style.css，就写r.Static("/a/b/c", "./asset/css") - Gin 不会自动处理
index.html里的相对路径引用——比如页面在/，里面写了<script src="js/app.js"></script>，那请求的是/js/app.js，不是/index.html/js/app.js。所以 HTML 里仍要写绝对路径
embed 方式打包静态资源要注意什么？
Go 1.16+ 的 embed 能把 CSS/JS/图片编译进二进制，适合单文件分发场景，但有几点容易踩坑：
-
//go:embed指令只能出现在包级变量声明上方，且变量类型必须是embed.FS，不能是普通string或[]byte - 路径是相对于
.go文件所在目录的，比如main.go在项目根目录，//go:embed static/*就指./static/下所有文件 - 嵌入后文件系统是只读的，
http.FileServer(http.FS(staticFiles))可以用，但别试图用os.WriteFile去改它 - 若 HTML 里仍用
/static/xxx，那注册 handler 时还得配http.StripPrefix("/static/", ...)，embed 只解决“文件在哪”，不解决“URL 怎么路由”
真正麻烦的从来不是怎么写那一行 http.Handle，而是三处路径：HTML 里怎么写、Go 里怎么注册、磁盘上文件放哪——漏看一个斜杠或少个点，资源就加载失败。调试时先打开浏览器 Network 面板，盯着那个 200 返回 HTML 的 CSS 请求，反向查这三处，基本就能定位。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
