前端开发者转型的Golang开发环境配置建议-Golang-PHP中文网

vite开发时调用go后端api不跨域的唯一正确方式是在vite.config.ts中配置proxy，设置changeorigin: true和严格匹配的rewrite规则，使/api请求代理至go服务，而非在go中添加cors中间件；开发阶段go仅提供api接口，不托管未构建的前端源码。

前端开发者转型的golang开发环境配置建议

前端开发者转 Go，不用重学整个生态，重点是把熟悉的开发流（热更新、代理、构建产物托管）和 Go 的服务端能力对齐。Go 不替代 Vite/Webpack，而是补足它缺的那块：API 服务、静态文件托管、SPA fallback 和单二进制部署。

Vite 本地开发（localhost:5173）直接请求 /api/users 会触发浏览器同源策略拦截，不是 Go 拒绝，是浏览器根本没发出去。解决方式只有一种：在 vite.config.ts 里配代理，而不是在 Go 里加 CORS 中间件。

server.proxy 必须设 changeOrigin: true，否则 Go 收到的 Host 头还是 localhost:5173，某些中间件（如基于 Host 路由的）会出错
rewrite 正则要带锚点：path.replace(/^\/api/, '')，不然 /api/v1/api/user 会被截两次
Go 路由必须严格以 /api 开头，比如 r.HandleFunc("/api/users", handler)，和代理前缀完全一致
开发阶段不要在 Go 里写 Access-Control-Allow-Origin: * —— 这会让预检请求（OPTIONS）绕过代理，反而暴露后端端口，破坏开发一致性

Vite 的 dev server 不是简单返回文件，它靠内存模块图 + WebSocket 实现 HMR（热更新）、source map 定位、ESM 动态导入解析。Go 的 http.FileServer 没这些能力，强行挂载只会导致：

结论：前端必须用 npx vite 启动，Go 只负责 /api 接口；生产才轮到 Go 托管构建后的 dist/。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

Go 1.16+ 的 embed.FS 是唯一靠谱方案。它不是“复制文件”，而是在编译期把文件内容硬编码进二进制，运行时不依赖外部路径。

嵌入语句必须写在 main.go 文件顶部，且路径需与实际构建输出完全一致：//go:embed dist/*（若构建到 frontend/dist，就得写 //go:embed frontend/dist/*）
必须先执行 npm run build（或 pnpm build），再执行 go build；Go 不会自动触发前端构建
通配符 dist/* 不包含子目录下隐藏文件（如 .gitkeep），若需占位，得显式列出或改用 dist/**/*（Go 1.20+ 支持）
构建命令建议加 -ldflags="-s -w"，否则二进制体积可能多出 2–3MB（调试符号 + DWARF 信息）

Vue Router / React Router 是前端路由，URL 改变不发请求。但用户手动刷新 localhost:8080/user/profile 时，浏览器会向 Go 发 GET 请求，而 Go 默认找不到该路径，返回 404。

解决方案不是“所有路径都返回 index.html”，而是只对非 API、非静态资源的路径 fallback —— 否则会掩盖真实 404（比如请求一个不存在的图片）
推荐用 http.StripPrefix + 自定义 http.HandlerFunc 判断：先尝试按路径找文件，找不到且路径不匹配 /api、/assets 等已知前缀时，才返回 index.html
如果用 Gin，别直接上 router.NoRoute，它会捕获所有未注册路由（包括你忘了写的健康检查接口），应优先匹配已知静态路径，最后 fallback
注意：这个逻辑只在生产托管时生效，开发阶段由 Vite 自己处理，无需 Go 参与