Go语言实战案例:简易JSON数据返回

在现代 Web 应用中,JSON 已成为前后端通信的主流数据格式。Go 语言标准库内置对 JSON 的良好支持,只需少量代码就能返回结构化的 JSON 响应。

本篇案例将手把手带你完成一个「返回 JSON 数据的 HTTP 接口」,帮助你理解如何用 Go 语言实现后端服务最基础的功能。


一、目标说明

构建一个 HTTP 服务:

  • • 请求地址:/hello

  • • 请求方式:GET

  • • 返回内容:

    json 复制代码
    {
      "message": "Hello, Go!",
      "status": 200
    }

二、核心知识点

  • net/http:Go 标准 HTTP 库
  • encoding/json:JSON 编解码包
  • http.ResponseWriter:响应写入器
  • http.HandleFunc:注册处理函数

三、完整代码示例

go 复制代码
package main

import (
    "encoding/json"
    "net/http"
)

type Response struct {
    Message string `json:"message"`
    Status  int    `json:"status"`
}

func helloHandler(w http.ResponseWriter, r *http.Request) {
    // 设置返回头信息
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(http.StatusOK)

    // 创建响应结构体
    resp := Response{
        Message: "Hello, Go!",
        Status:  200,
    }

    // 编码为 JSON 并写入响应
    json.NewEncoder(w).Encode(resp)
}

func main() {
    http.HandleFunc("/hello", helloHandler)
    http.ListenAndServe(":8080", nil)
}

四、运行与测试

1. 运行服务

go 复制代码
go run main.go

访问浏览器或使用 curl

bash 复制代码
curl http://localhost:8080/hello

2. 响应结果

json 复制代码
{
  "message": "Hello, Go!",
  "status": 200
}

五、快速问答(FAQ)

✅ 为什么要设置 Content-Type: application/json

告诉浏览器或客户端,我们返回的是 JSON 格式数据。

json.NewEncoder(w).Encode(...) 做了什么?

它将结构体编码为 JSON 并直接写入到 ResponseWriter 输出流。

✅ 如果编码失败会发生什么?

Encode() 会返回 error,可以用 if err != nil 判断并手动写入 500 错误。


六、延伸练习

    1. 返回一个包含用户列表的 JSON 数组;
    1. 增加 POST 方法处理 JSON 请求体;
    1. 返回当前时间戳;
    1. 返回分页数据结构。

七、总结

本案例实现了一个 Go 最小可用的 JSON 接口:

✅ 使用标准库,无需第三方框架

✅ 面向新手,极易上手

✅ 为构建 RESTful API 打下基础


相关推荐
fured42 分钟前
[调试][实现][原理]用Golang实现建议断点调试器
开发语言·后端·golang
围巾哥萧尘1 小时前
烟花模拟器 Fireworks Simulator 🧣
trae
bobz9651 小时前
linux cpu CFS 调度器有使用 令牌桶么?
后端
bobz9651 小时前
linux CGROUP CPU 限制有使用令牌桶么?
后端
David爱编程2 小时前
多核 CPU 下的缓存一致性问题:隐藏的性能陷阱与解决方案
java·后端
围巾哥萧尘2 小时前
AI智能旅游规划 让每次旅行都完美无缺🧣
trae
追逐时光者2 小时前
一款基于 .NET 开源、功能全面的微信小程序商城系统
后端·.net
绝无仅有3 小时前
Go 并发同步原语:sync.Mutex、sync.RWMutex 和 sync.Once
后端·面试·github
绝无仅有3 小时前
Go Vendor 和 Go Modules:管理和扩展依赖的最佳实践
后端·面试·github
自由的疯4 小时前
Java 实现TXT文件导入功能
java·后端·架构