gin 的 static 用于把整个本地目录映射到一个 url 前缀,staticfile 用于把单个文件映射到固定 url。访问地址不需要包含本地目录名,除非你把它也设成路由前缀。下面创建一个最小项目,再分别验证目录文件与单文件路由,最后按需关闭目录列表。

创建 Gin 项目并准备可直接访问的静态文件
在终端执行以下命令,安装 Gin 时按当前模块版本的 Go 工具链要求运行。示例命令采用 macOS 或 Linux shell,Windows 可手动创建同样的目录与文件。index.txt 只是测试文本,不作为网页首页。
mkdir gin-static-demo
cd gin-static-demo
go mod init example.com/gin-static-demo
go get github.com/gin-gonic/gin
mkdir public
printf 'body { color: #234; }
' > public/app.css
printf 'static file ready
' > public/index.txt
# 目录结构:
# gin-static-demo/
# go.mod
# go.sum
# public/app.css
# public/index.txt
# main.go(下一节创建)后续命令都在 gin-static-demo 目录执行。./public 按进程工作目录解析,换个目录启动程序可能导致找不到文件;不要把存放私钥、配置或用户隐私文件的目录直接作为静态目录。
用 Static 配置目录,用 StaticFile 配置固定地址
保存下面程序为 main.go,执行 go run .,另开终端运行代码末尾的 curl 命令。/assets/app.css 对应 public/app.css;/notice.txt 直接对应 public/index.txt,两种路由在此配置中互不冲突。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
package main
import (
"log"
"github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
router.Static("/assets", "./public")
router.StaticFile("/notice.txt", "./public/index.txt")
if err := router.Run("127.0.0.1:8080"); err != nil {
log.Fatal(err)
}
}
// 另一个终端执行:
// curl -i http://127.0.0.1:8080/assets/app.css
// curl -i http://127.0.0.1:8080/notice.txt
// curl -i http://127.0.0.1:8080/assets/missing.css前两次请求预期返回 200,正文分别为 CSS 和 static file ready。不存在的 missing.css 预期返回 404。单文件地址可以与磁盘文件名不同;不要把 /public/app.css 当作已经注册的 URL。

需要关闭目录列表时,改用 StaticFS 和 gin.Dir
若不希望列出目录中的文件名,停止前一个程序,将 main.go 替换为下面版本,然后重新执行 go run .。StaticFS 使用同一前缀替代 Static,不能保留两条相同通配路由重复注册。
package main
import (
"log"
"github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
router.StaticFS("/assets", gin.Dir("./public", false))
router.StaticFile("/notice.txt", "./public/index.txt")
if err := router.Run("127.0.0.1:8080"); err != nil {
log.Fatal(err)
}
}
// 预期仍可返回 CSS 内容:
// curl -i http://127.0.0.1:8080/assets/app.css
// 检查没有 index.html 的目录不再列出文件名:
// curl -i http://127.0.0.1:8080/assets/gin.Dir 的 false 用于禁止目录列表,已知路径的文件仍可访问;如果目录中有 index.html,它仍可能被作为目录首页返回。禁止列表不等于访问鉴权,应只在 public 内保存允许公开的资源。


















