Golang Web项目不“连”前端，而是通过API接口或静态服务被前端主动调用；开发时需用Vite代理解决跨域，生产时用Nginx或CORS中间件，同时必须配置SPA fallback以支持前端路由刷新。
直接说结论：
Golang Web 项目不“连”前端，而是提供接口或静态服务，前端主动调用它
。所谓“连接”，本质是解决通信路径、协议一致性和开发协同问题，不是建立某种绑定关系。
前端发请求，Go 后端必须能收到且不被浏览器拦住
这是最常卡住的第一步。现象是前端 fetch 报错：
。
浏览器只认同源（协议+域名+端口全等），
和
就算都在本地也算跨域
Go 默认不设任何 CORS 头，请求直接被拦截，后端甚至收不到
不要用“前端改请求方式绕过”，那是自欺欺人；必须后端显式声明允许谁来调
常见做法：
开发阶段用 Vite 的
把
前缀代理到
，此时前端请求仍发给
，Vite 自动转发，不触发跨域
生产环境用 Nginx 反向代理，或 Go 后端加 CORS 中间件（如
），但注意：若前端带
（比如 cookie 或
头），
就不能写
，必须指定具体域名
前后端数据格式和时间字段必须对齐
前端解析失败、时间显示错乱、字段突然变
，八成是结构没对齐。
立即学习
“
go语言免费学习笔记（深入）
”；
面向设计的AXUI前端框架表单
面向设计的AXUI前端框架表单是一款包含表格、列表、弹窗等的AXUI前端框架表单下载。
下载
所有接口响应必须是标准 JSON，顶层固定为
，不能直接
定义统一响应结构体，例如：
时间字段一律用 RFC3339 格式（如
），不要传 Unix 时间戳或自定义字符串；Go 里用
默认就输出这个格式
前端传参也得守规矩：JSON 请求必须带
，否则
（Gin）会静默失败，返回空结构体
路由路径和参数解析要匹配前端预期
前端发
，后端却只注册了
，或者想从
提取 ID 却手动切字符串出错。
Go 标准库
的
不支持路径参数（如
），得靠框架（Gin/Echo）或自己解析
Gin 写法：
若用标准库，得手动处理：
但这种写法难维护，尤其带可选参数或嵌套时，建议直接上 Gin
静态资源托管别硬塞进 API 路由
有人把
放在
handler 里
，结果前端刷新
页面 404——因为 Go 没配 SPA fallback。
正确做法：用
托管构建后的
目录，并加 fallback：
这样无论访问
、
还是
，都能加载
，由 Vue/React Router 处理
真正容易被忽略的点是：
CORS 配置和静态 fallback 是两个独立问题，混在一起调试会互相干扰；先确保 API 能通，再处理页面路由，顺序错了排查成本翻倍
。
Access to fetch at 'https://www.php.cn/link/9f094b9ffa0f7dd89f0f2d3eeaf7c139' from origin 'https://www.php.cn/link/8e5687e2d6ab87e5da2f833f3e8986a4' has been blocked by CORS policyhttps://www.php.cn/link/8e5687e2d6ab87e5da2f833f3e8986a4https://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8eserver.proxy/apihttps://www.php.cn/link/cbb686245ece57c9827c4bc0d0654a8ehttps://www.php.cn/link/8e5687e2d6ab87e5da2f833f3e8986a4/api/xxxgithub.com/rs/corscredentialsAuthorizationAccess-Control-Allow-Origin*null{ "code": 0, "msg": "", "data": {} }json.NewEncoder(w).Encode(map[string]interface{}{"user": u})type Resp struct {
Code int `json:"code"`
Msg string `json:"msg"`
Data interface{} `json:"data"`
}"2026-04-27T19:50:00Z"time.Time.MarshalJSON()Content-Type: application/jsonc.ShouldBindJSON()GET /api/users?page=1&size=20/api/users/api/users/123net/httpServeMux/users/:idr.GET("/api/users/:id", func(c *gin.Context) {
id := c.Param("id") // 自动提取
// ...
})pathParts := strings.Split(r.URL.Path, "/")
if len(pathParts) >= 4 && pathParts[3] != "" {
id := pathParts[3]
}index.htmlGET /c.File("index.html")/user/123http.FileServerdistfs := http.FileServer(http.Dir("./dist"))
http.Handle("/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// 尝试找真实文件
if _, err := os.Stat("./dist" + r.URL.Path); err == nil {
fs.ServeHTTP(w, r)
return
}
// 找不到就返回 index.html，让前端路由接管
http.ServeFile(w, r, "./dist/index.html")
}))//user/123/settingsindex.html