GoLand只是IDE，不提供静态服务器；真正起作用的是http.FileServer或gin.Engine代码；跨域问题主因是未正确配置CORS响应头，需处理OPTIONS预检并设置Access-Control-Allow-Origin等头。
GoLand 本身不提供静态资源服务器功能，所谓“配置 GoLand 启动静态服务器”是常见误解——它只是 IDE，真正起作用的是你写的 http.FileServer 或 gin.Engine 代码。跨域调试卡住，90% 是本地前端（如 npm run serve）和后端 Go 服务端口不同、协议不同、域名不同，触发了浏览器同源策略，而你又没在 Go 服务里正确配置 CORS 响应头。
Go 服务没配 CORS，浏览器直接拦截请求
前端发请求到 http://localhost:8080/api/user，但页面来自 http://localhost:3000，浏览器看到 Origin 不匹配，先发一次 OPTIONS 预检，如果 Go 服务没响应 Access-Control-Allow-Origin 等头部，就直接报错，连 GET/POST 都不会发出去。
- 错误典型表现：
Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present - 不要只在业务 handler 里加 header——OPTIONS 请求必须被拦截并提前返回 200，不能落到后续逻辑里
- 用
github.com/rs/cors最省事：r.Use(cors.Default())，但生产环境别用Default()，它等价于允许所有源（*），会拒绝带凭证的请求 - 更稳妥的手动写法：中间件里判断
r.Method == "OPTIONS"就w.WriteHeader(http.StatusOK)并 return，绝不调用next.ServeHTTP
Gin 的 Static 路由和 API 路由顺序搞反了
如果你用 r.Static("/", "./dist") 把整个前端 dist 目录挂到根路径，那所有未定义的路由（包括 /api/user）都会被当成静态文件去找，结果就是 API 返回 404 或直接返回 index.html 内容——你看到的“JSON 数据变成 HTML 字符串”，就是这个原因。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 必须把 API 路由写在
r.Static或r.NoRoute之前，确保/api/*先匹配上 - SPA 应用（Vue/React history 模式）需要兜底：
r.NoRoute(func(c *gin.Context) { c.File("./dist/index.html") })，但这条必须放最后 -
r.Static("/static", "./dist/static")和前端 HTML 中的<script src="/static/js/app.js">必须完全一致，路径大小写、斜杠、子目录名一个都不能错
filepath.Abs 没用，相对路径在 GoLand 运行配置里会崩
你在 GoLand 里点 ▶️ 运行 main.go，当前工作目录默认是项目根目录；但如果用 systemd、Docker 或 CI 启动，工作目录可能是 / 或 /app，这时 http.Dir("static") 就找不到文件，stat static: no such file 导致 404。
- 永远用
filepath.Abs("./static")获取绝对路径，再传给http.Dir - Windows 下注意路径分隔符：
filepath.ToSlash(absPath)统一转成正斜杠，避免os.Stat失败 - 嵌入资源用
embed.FS时，路径必须是编译期字面量：//go:embed dist/*，不能拼接变量，也不能用filepath.Join
想绕过跨域？别靠 GoLand，改前端启动方式更直接
开发阶段最干净的跨域解法，不是在 Go 里狂配 CORS，而是让前端和后端同源——用 vue.config.js 或 vite.config.ts 配 proxy，把 /api 请求代理到 localhost:8080。这样浏览器看到的全是 localhost:3000，根本不会触发跨域。
- Vue CLI：
devServer.proxy指向 Go 后端地址 - Vite：
server.proxy配置对象，"/api": { "target": "http://localhost:8080", "changeOrigin": true } - 这个方案下，Go 服务甚至可以完全不配 CORS，专注业务逻辑
真正的坑不在 GoLand 设置里，而在你写的那几行 http.Handle 和 r.Static 是否对齐了三重路径：浏览器请求路径、路由注册前缀、磁盘文件位置。任何一环松动，404 或跨域报错就来了。
