Golang构建基于文件路径映射的简单路由系统-Golang-PHP中文网

http.fileserver不能直接用于路径映射，因其仅按请求路径字面拼接文件系统路径，不做任何转换；如注册/static却访问/static/js/app.js，会查./public/static/js/app.js而非./public/js/app.js，必须配合http.stripprefix剥离前缀才能正确映射。

golang构建基于文件路径映射的简单路由系统

Go 标准库的 http.ServeMux 本身不支持路径映射（如把 /api/v1/users 映射到 /v2/users），必须自己处理路径重写或引入中间层；直接用 http.Handle + http.FileServer 只能做静态挂载，无法动态改写请求路径。

为什么 http.FileServer 不能直接用于路径映射

http.FileServer 是纯静态文件服务，它只根据请求路径查找本地文件系统对应位置，不做任何路径转换。比如你注册 http.Handle("/static", http.FileServer(http.Dir("./public")))，访问 /static/js/app.js 会去查 ./public/js/app.js —— 它不会把 /static 替换成别的前缀，也不会忽略或截断原始路径。

常见错误现象：

想把 /assets/* 映射到 ./dist/*，但实际访问 /assets/logo.png 报 404，因为 FileServer 拼的是 ./dist/assets/logo.png
误以为 http.StripPrefix 能“重定向”，其实它只是在调用 FileServer 前把路径前缀去掉，不改变路由注册逻辑

用 http.StripPrefix + FileServer 实现路径挂载

这是最轻量、也最常用的方式，适用于「请求路径前缀 = 文件系统相对路径」的场景。关键点是：StripPrefix 的字符串必须和 http.Handle 注册的路径完全一致，且顺序不能错。

正确做法：

注册路径为 /files，就用 http.StripPrefix("/files", ...)，不能写成 "/files/"（尾部斜杠多一个就会匹配失败）
http.Dir 参数是真实文件系统路径，不是 URL 路径；例如 http.Dir("/var/www") 对应访问 /files/xxx 时读取 /var/www/xxx
Windows 下盘符路径需用双反斜杠或正斜杠，如 http.Dir("C:/data")，避免 "C:\data" 中的 \d 被解析为转义字符

示例：

func main() {
	mux := http.NewServeMux()
	mux.Handle("/files/", http.StripPrefix("/files/", http.FileServer(http.Dir("./dist"))))
	http.ListenAndServe(":8080", mux)
}

手动实现路径映射：拦截并重写 r.URL.Path

当需要非一一对应的映射关系（比如 /api/docs → ./swagger/index.html，或 /v1/* → /v2/），就得自己写 handler 拦截请求。标准库没提供 Rewrite 功能，必须显式修改 r.URL.Path 并调用目标 handler。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

注意点：

r.URL.Path 是解码后的路径，含中文或特殊字符时可能丢失原始编码；若需精确转发，优先用 r.URL.EscapedPath()
修改 r.URL.Path 后，r.URL.RawPath 不会自动同步，某些依赖 RawPath 的库（如 url.ParseQuery）会出错，建议手动设 r.URL.RawPath = r.URL.EscapedPath()
不要直接 return 或 panic，要继续调用 http.ServeFile 或 http.FileServer 实例，否则响应头、状态码等底层逻辑会缺失

简单映射示例（/docs → ./swagger）：

func docsHandler(w http.ResponseWriter, r *http.Request) {
	if r.URL.Path == "/docs" || r.URL.Path == "/docs/" {
		http.ServeFile(w, r, "./swagger/index.html")
		return
	}
	http.ServeFile(w, r, "./swagger/"+strings.TrimPrefix(r.URL.Path, "/docs/"))
}