Go语言实战案例:静态资源服务(CSS、JS、图片)

在 Web 开发中,除了提供 API 接口外,往往还需要对外提供静态资源服务,比如:

  • • CSS 样式文件
  • • JavaScript 脚本
  • • 图片、字体等静态资源

Go 的 net/http 包和 Gin 框架都提供了方便的方式来托管这些静态文件。

本篇我们将用 Gin 框架 演示如何快速构建一个静态资源服务。


一、功能目标

    1. 使用 Gin 提供一个静态资源目录,让用户能直接访问 CSS、JS、图片。
    1. 演示 HTML 页面引入这些静态资源。
    1. 支持前端直接访问 /static/... 路径获取文件。

二、项目结构

假设我们的项目目录结构如下:

arduino 复制代码
project/
│── main.go
│── static/
│     ├── css/
│     │    └── style.css
│     ├── js/
│     │    └── app.js
│     └── images/
│          └── logo.png
└── templates/
      └── index.html

三、代码实现

go 复制代码
package main

import (
    "github.com/gin-gonic/gin"
    "net/http"
)

func main() {
    r := gin.Default()

    // 1. 加载模板
    r.LoadHTMLGlob("templates/*")

    // 2. 提供静态文件服务
    //   /static 对应项目下的 static 目录
    r.Static("/static", "./static")

    // 3. 首页路由
    r.GET("/", func(c *gin.Context) {
        c.HTML(http.StatusOK, "index.html", nil)
    })

    // 启动服务器
    r.Run(":8080")
}

四、HTML 模板示例

templates/index.html:

xml 复制代码
<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="UTF-8">
    <title>静态资源示例</title>
    <!-- 引入 CSS -->
    <link rel="stylesheet" href="/static/css/style.css">
</head>
<body>
    <h1>欢迎来到 Go 静态资源服务示例</h1>
    <!-- 引入图片 -->
    <img src="/static/images/logo.png" alt="Logo" width="150">

    <!-- 引入 JS -->
    <script src="/static/js/app.js"></script>
</body>
</html>

五、静态资源示例

static/css/style.css:

css 复制代码
body {
    background-color: #f5f5f5;
    font-family: Arial, sans-serif;
    text-align: center;
}
h1 {
    color: #333;
}

static/js/app.js:

javascript 复制代码
document.addEventListener("DOMContentLoaded", function() {
    console.log("JavaScript 已加载");
});

六、运行与访问

运行服务:

go 复制代码
go run main.go

在浏览器访问:

arduino 复制代码
http://localhost:8080/

你会看到页面正常加载了 CSS 样式、图片和 JavaScript 脚本。

静态资源也可以直接访问:

bash 复制代码
http://localhost:8080/static/images/logo.png
http://localhost:8080/static/css/style.css

七、总结

  • • Gin 提供 Static() 方法一行就能完成静态文件托管。
  • • 静态文件路径映射和 URL 前缀可以灵活配置。
  • • 结合 HTML 模板,可以很方便地构建完整的前端页面服务。

相关推荐
码事漫谈29 分钟前
以后人人都可以成为导演
后端
Resean022336 分钟前
Spring 源码分析(二)配置类的解析与扫描
java·后端·spring
一只爱撸猫的程序猿37 分钟前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
北城笑笑2 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
ServBay3 小时前
Local harness 将退役,VS Code 本地开发要不要搬到云端?
后端·ai编程·visual studio code
ashiho3 小时前
【LeetCode hot 100】3. 无重复字符的最长子串 (三种解法)
java·数据结构·后端·算法·leetcode·滑动窗口
张一凡934 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
00后程序员4 小时前
iOS 实时活动怎么开发,Windows 上用 KXBuild 和 ActivityKit 写灵动岛
后端·ios
程序员cxuan4 小时前
推荐 10 个 WorkBuddy 中的邪修用法
人工智能·后端·程序员
Bacon5 小时前
给项目做一次"全身 CT":Agent Skills 生态里的代码体检全链路
前端·人工智能·后端