goland不参与静态资源路径配置，真正决定访问能力的是代码中http.fileserver或gin.staticfs的路径传参及是否使用embed.fs；working directory需设为$projectfiledir$，//go:embed路径必须相对.go文件，且router.static不支持embed.fs，须改用router.staticfs。
GoLand 本身不参与静态资源路径配置，它只负责运行时工作目录和构建参数；真正决定静态资源能否被访问的，是 Go 代码里 http.FileServer 或 gin.StaticFS 的路径传参方式，以及是否用了 embed.FS。
GoLand 的 Working directory 必须设对，否则 ./static 找不到
GoLand 默认把 Working directory 设为项目根目录，但如果你在子目录（如 cmd/server/main.go）右键 Run，而代码里写的是 http.Dir("./static")，那它实际查找的是 cmd/server/static，不是你预期的项目根下的 ./static。
- 进 Run Configuration → Working directory 改成
$ProjectFileDir$（即项目根），这是最稳妥的选择 - 不要用
$FileDir$，除非你所有静态资源都放在每个main.go同级目录下 - 验证方法：在 main 函数开头加
fmt.Println("cwd:", os.Getwd())，看输出路径是否包含你的static目录
用 embed.FS 时，GoLand 不需要额外配置，但 go:embed 路径必须相对 .go 文件
//go:embed 的路径解析完全由 Go 编译器完成，跟 IDE 无关。但常见错误是误以为它能跨目录匹配，或忽略大小写和隐藏文件限制。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 写
//go:embed static/**才能递归嵌入子目录，static/*只包一层 - 路径必须相对于当前
.go文件所在位置，不能写//go:embed ../static - 嵌入后用
fs.WalkDir(staticFiles, ".", ...)在启动时打印所有路径，确认static/css/app.css真的存在 - GoLand 不会高亮或校验
//go:embed是否生效，一切以构建后运行结果为准
Gin 项目中 router.Static 和 router.StaticFS 混用会 panic
很多人在 GoLand 里改了 router.Static("/static", "./static") 就以为完事了，上线一跑直接 panic：“invalid filesystem”。这是因为 router.Static 内部硬编码调用 http.Dir，不接受 embed.FS。
- 开发期快速验证：用
router.Static("/static", "./static")，确保./static是绝对路径（用filepath.Abs包一层） - 生产打包进二进制：必须换
router.StaticFS("/static", http.FS(staticFiles))，其中staticFiles是embed.FS类型变量 - 别在同一个路由上反复注册
Static和StaticFS，Gin 不合并，后注册的会覆盖前一个
浏览器请求 /static/logo.png 404？先查文件系统路径是否真有该文件
GoLand 不拦截或重写 HTTP 请求，所以 404 一定出在路径映射环节。最常被忽略的是 URL 前缀和本地路径的对应关系。
- 写
http.Handle("/static/", http.StripPrefix("/static/", fs))后，请求/static/js/app.js会去读./static/js/app.js（StripPrefix 已去掉前缀） - 但如果实际文件在
./dist/static/js/app.js，那你得写http.Dir("./dist/static")，而不是"./dist" - 检查
favicon.ico：它走的是根路径/favicon.ico，不是/static/favicon.ico，得单独用http.ServeFile注册或确保./static下真有这个文件
真正麻烦的从来不是怎么写代码，而是每次换环境（本地、Docker、systemd）都要重新验证 os.Getwd() 和 filepath.Abs() 的结果是否一致——嵌入式方案 embed.FS 虽然绕开了这个问题，但一旦漏写 ** 或路径大小写错一个字母，就静默失败，连日志都不报。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
