当前位置：首页 > news >正文

Go语言-初学者日记（七）：用 Go 写一个 RESTful API 服务！

news 来源：原创 2025/9/6 5:34:57

👷 实践是最好的学习方式！这一篇我们将用 Go + Gin 框架从零开始开发一个用户管理 API 服务。你将学到：

如何初始化项目并引入依赖
如何组织目录结构
如何用 Gin 实现 RESTful 接口
如何通过 curl 测试 API
进阶功能拓展建议

🧰 一、项目初始化与依赖安装

第一步，先创建项目目录并初始化 Go Modules：

mkdir go-user-api && cd go-user-api
go mod init github.com/yourname/go-user-api

然后安装我们将使用的 Web 框架 —— Gin：

go get -u github.com/gin-gonic/gin

✅ 你现在已经具备开发 Go Web 服务的基本环境。

📁 二、推荐的项目目录结构

保持简单，便于理解，也方便未来扩展：

go-user-api/
├── main.go               # 应用入口
├── go.mod                # 模块定义
├── go.sum                # 依赖锁定文件
├── handlers/             # 路由处理逻辑
│   └── user.go
└── models/               # 数据模型结构体（可选）

📌 提醒：随着项目变复杂，可拆分出 service/, middleware/, config/, router/, utils/ 等目录。

🧪 三、实现用户 API 接口

目标是实现两个基础接口：

GET /users：返回所有用户数据
POST /users：添加一个新用户

📄 main.go

package mainimport ("github.com/gin-gonic/gin""go-user-api/handlers"
)func main() {r := gin.Default()// 注册路由r.GET("/users", handlers.GetUsers)r.POST("/users", handlers.CreateUser)// 启动服务r.Run(":8080")
}

📄 handlers/user.go

package handlersimport ("net/http""github.com/gin-gonic/gin"
)// 模拟用户结构体和数据
type User struct {ID   int    `json:"id"`Name string `json:"name"`
}var users = []User{{ID: 1, Name: "Alice"},{ID: 2, Name: "Bob"},
}// GET /users
func GetUsers(c *gin.Context) {c.JSON(http.StatusOK, users)
}// POST /users
func CreateUser(c *gin.Context) {var newUser Userif err := c.ShouldBindJSON(&newUser); err != nil {c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})return}newUser.ID = len(users) + 1users = append(users, newUser)c.JSON(http.StatusCreated, newUser)
}

🧪 四、启动服务并测试接口

启动服务：

go run main.go

服务默认监听 http://localhost:8080

使用 curl 测试接口

📥 获取用户列表：

curl http://localhost:8080/users

📤 添加新用户：

curl -X POST http://localhost:8080/users   -H "Content-Type: application/json"   -d '{"name":"Charlie"}'

返回示例：

{"id": 3,"name": "Charlie"
}

🔧 五、接口设计补充说明

请求方法	路径	含义
GET	/users	查询所有用户
GET	/users/:id	查询单个用户
POST	/users	创建新用户
PUT	/users/:id	更新用户信息
DELETE	/users/:id	删除用户

📦 六、进阶拓展建议

✅ 想继续提升？你可以尝试：

🗄 接入 GORM 实现真实数据库（SQLite / MySQL）
✏️ 添加表单校验：使用 Gin 的 binding + validator
🔐 增加登录、注册与 JWT 身份认证
🧪 编写单元测试（使用 httptest.NewRecorder()）
🛡️ 使用中间件做访问日志、限流、错误恢复等处理
📂 添加日志框架如 zap，记录结构化日志
📚 提取配置文件（使用 viper 管理 YAML/JSON）

🧠 七、小结与回顾

本篇我们完成了一个完整的 Go + Gin 实战项目的搭建和基本功能实现。你已经学到了：

如何初始化 Go 项目并安装依赖
如何用 Gin 实现基础的 API 路由与处理
如何通过 curl 工具测试接口
如何组织项目目录结构以支持未来拓展

📌 实战才是学习的核心，加油！后续我们会继续介绍部署与上线技巧 🚀

🪧 下一篇预告

🚀 Go语言-初学者日记（八）：部署与构建——Go 项目上线指南
包括 go build 编译、Docker 打包、环境变量配置、部署上线等内容，敬请期待！

Go语言-初学者日记（七）：用 Go 写一个 RESTful API 服务！

👷 实践是最好的学习方式！这一篇我们将用 Go Gin 框架从零开始开发一个用户管理 API 服务。你将学到： 如何初始化项目并引入依赖如何组织目录结构如何用 Gin 实现 RESTful 接口如何通过 curl 测试 API进阶功能拓展建议 🧰 一、项…...

编程日记 2025/9/6 5:34:57

数据结构：手工创建表达式树的方法

1. 表达式树表达式树（Binary Expression Tree）是一类特殊的二叉树，用以表示表达式，如图 7.6.1 所示，是一棵表示了 a b * c d * (e f) 的表达式树。图 7.6.1 表达式树示例表达式树有如下特点： 操作数…...

编程日记 2025/9/6 5:34:21

自定义类型：联合和枚举

文章目录前言一、联合体类型的声明1.1 联合体类型的声明1.2 联合体的特点1.3 相同成员的结构体和联合体对比1.4 联合体大小的计算1.5 联合体的一个练习二、枚举类型的声明2.1 枚举类型的声明2.2 枚举类型的优点2.3 枚举类型的使用1. 用于 switch 语句2. 作为函数参数总结前…...

编程日记 2025/9/4 15:06:57

注意力机制

实现了Bahdanau式加法注意力的核心计算逻辑。以下是三个线性层设计的完整技术解析： 一、数学公式推导注意力分数计算流程： s c o r e ( h d e c , h e n c ) v T ⋅ tanh ⁡ ( W 1 ⋅ h e n c W 2 ⋅ h d e c ) score(h_{dec}, h_{enc}) v^T \cdot …...

编程日记 2025/9/4 15:06:54

OrangePi5Plus开发板不能正确识别USB 3.0 设备（绿联HUB和Camera）

1、先插好上电（可正确识别） 2、上电开机后插，报错如下，只能检测到USB2.0--480M，识别不到USB3.0-5Gbps，重新插拔也不行 Apr 4 21:30:00 orangepi5plus kernel: [ 423.575966] usb 5-1: reset high-speed…...

编程日记 2025/9/6 5:33:00

目录一. KubeVirt简介 1.1 KubeVirt的价值 1.2 KubeVirt架构 1.3 KubeVirt组件 1.4 KubeVirt流程管理 KubeVirt实战 2.1 Kubevirt安装 2.1.1节点规划 2.1.2 环境准备 2.1.3 安装KubeVirt 2.1.4 安装CDI 2.1.5 安装virtctl命令工具 2.1.6 生成官方虚拟机 2.1.7 进…...

编程日记 2025/9/6 5:31:56

游戏引擎学习第202天

调试器：启用“跳转到定义/声明”功能开始了一个完整游戏的开发过程，并分享了一些实用技巧。首先，讨论了如何在 Visual Studio 中使用“跳转到定义”和“跳转到声明”功能，但当前的项目并未启用这些功能，因为缺少浏览…...

编程日记 2025/9/4 15:06:43

sqlalchemy查询json

第一种：字段op是json格式： {"uid": "cxb123456789","role": 2,"op_start_time": 1743513707504,"op_end_time": 1743513707504,"op_start_id": "op_001","op_end_id"…...

编程日记 2025/9/4 3:42:51

2024第十五届蓝桥杯大赛软件赛省赛C/C++ 大学 B 组

记录刷题的过程、感悟、题解。希望能帮到，那些与我一同前行的，来自远方的朋友😉 大纲： 1、握手问题-（解析）-简单组合问题（别人叫她鸽巢定理）😇，感觉叫高级了…...

编程日记 2025/9/4 15:06:35

Linux系统之wc命令的基本使用

Linux系统之wc命令的基本使用一、命令简介二、基本语法格式三、核心功能选项四、典型使用案例4.1 创建示例文件4.2 基础统计操作4.3 组合选项使用4.4 管道流处理五、高级应用技巧4.1 递归统计代码行数4.2 统计CSV文件数据量4.3 监控日志增长速率4.4 字符与字节差异说明七、命…...

编程日记 2025/9/5 4:08:56

SQL Server 2022 脏读问题排查与思考

总结sqlserver的使用，总是会回想起很多开发过程当中加班努（拼）力（命）的场景，今天，就把之前一个由于数据库脏读到这的OA系统员工请假流程状态不一致问题和解决思路分享一下。业务场景描述由于…...

编程日记 2025/9/4 15:06:28

Linux系统时间

1. Linux系统时间 jiffies是linux内核中的一个全局变量，用来记录以内核的节拍时间为单位时间长度的一个数值。 jiffies变量开机时有一个基准值，然后内核每过一个节拍时间jiffies就会加1。一个时间节拍的时间取决于操作系统的配置，Linux系统一…...

编程日记 2025/9/4 14:46:32

【Windows批处理】命令入门详解

Windows 批处理（Batch Script）是一种用于在 Windows 操作系统上自动执行命令的脚本语言。它基于 Windows 命令提示符（cmd.exe）并使用 .bat 或 .cmd 文件格式。一、批处理基础 1. 创建批处理文件批处理脚本本质上是一组按顺序执…...

编程日记 2025/9/4 4:32:07

fpga系列 HDL：ModelSim 条件断点调试 modelsim支持的tcl语言

条件断点调试配置流程： 触发动作用tcl语言描述,modelsim支持的tcl语言见：https://home.engineering.iastate.edu/~zzhang/courses/cpre581-f08/resources/modelsim_quickguide.pdf 运行效果：...

编程日记 2025/9/4 15:06:18

Linux: network: 两台直连的主机业务不通

前提环境，有一个产品的设定是两个主机之间必须是拿网线直连。但是设备管理者可能误将设置配错，不是直连。最近遇到一个问题，说一个主机发的包，没有到对端，一开始怀疑设定的bond设备的问题，检查了bond的设置状态，发现没有问题，就感觉非常的奇怪。后来就开始怀疑两个主机…...

编程日记 2025/9/4 15:06:14

虚拟地址空间布局架构

一、内存管理架构 1.Linux内核整体架构以及子系统内存管理子系统架构分为用户空间、内核空间及硬件部分 3 个层面： 用户空间：应用程序使用malloc()申请内存资源，通过free()释放内存资源。内核空间：内核是操作系统的一部分&…...

编程日记 2025/9/4 13:05:18

在VMware下Hadoop分布式集群环境的配置--基于Yarn模式的一个Master节点、两个Slaver（Worker）节点的配置

你遇到的大部分ubuntu中配置hadoop的问题这里都有解决方法！！！（近10000字） 概要在Docker虚拟容器环境下，进行Hadoop-3.2.2分布式集群环境的配置与安装，完成基于Yarn模式的一个Master节点、两个…...

编程日记 2025/9/4 15:06:08

go day 01

go day 01 配置go环境 install go on D:\huang\lang\go\D:\huang\lang\go\bin\go xxx.go # D:\huang\lang\go\bin 设置到环境变量go go version# 创建任意一个目录,创建三个文件夹 # D:\huang\lang\goProject bin、pkg、src # 创建三个系统环境变量 GOROOT GOPATH GOBIN # GOR…...

编程日记 2025/9/4 15:06:04

（二）RestAPI 毛子(Tags)

文章目录项目地址一、给Habit添加Tags1.1 创建Tags1. 创建一个新的HabitTags实体2. 设置Habit和Tags的关系3. 设置HabitTag表4. 在HabitConfiguration里配置5. 将表添加到EFCore里6. 迁移数据 1.2 给Habit增加/修改标签1. 创建UpsertHabitTagsDto2. 创建查询HabitWithTagsDto3…...

编程日记 2025/9/6 0:22:18

Elasticsearch：使用机器学习生成筛选器和分类标签

作者：来自 Elastic Andre Luiz 探索使用机器学习模型与传统硬编码方法在搜索体验中自动创建筛选器和分类标签的优缺点筛选器和分类标签是用来优化搜索结果的机制，帮助用户更快速地找到相关内容或产品。在传统方法中，规则是手动定义的。例如…...

编程日记 2025/9/5 19:55:48

Python接口自动化测试之UnitTest详解

↵ 基本概念 UnitTest单元测试框架是受到JUnit的启发，与其他语言中的主流单元测试框架有着相似的风格。其支持测试自动化，配置共享和关机代码测试。支持将测试样例聚合到测试集中，并将测试与报告框架独立。它分为四个部分test fixture、Te…...

编程日记 2025/9/5 19:55:42

《概率论与数理统计》期末复习笔记_上

目录第1章随机事件与概率 1.1 随机事件 1.2 事件的关系与运算 1.3 概率的定义与性质 1.4 古典概型_重点 1.5 几何概型 1.6 条件概率与乘法公式 1.7 全概率公式与贝叶斯公式_重点 1.8 事件的独立性_重点 1.9 伯努利概型_重难点第2章随机变量及其分布 2.1 随机变…...

编程日记 2025/9/5 19:55:34

工程师 - Doxygen介绍

Code Documentation. Automated. Free, open source, cross-platform. Version 1.12.0 is now available! Release date: 7 August 2024 官方网址： Doxygen homepage 文档： Doxygen: Overview Github网址： https://github.com/doxygen/…...

编程日记 2025/9/5 19:55:29

开源且完全没有审核限制的大型语言模型的概述

开源且完全没有审核限制的大型语言模型的概述关键要点研究表明，存在多个开源的大型语言模型（LLM）完全没有审核限制，适合开放对话。包括基于 Llama、Mixtral、Phi-2 和 StableLM 的模型，参数范围从 2.78 亿到 4050 亿…...

编程日记 2025/9/5 19:55:23

Qt QTableView QAbstractTableModel实现复选框+代理实现单元格编辑

话不多说，直接看代码一、Model 1、QTableModel_Test.h #pragma once#include <QAbstractTableModel> #include <QObject> #include <QModelIndex>class QTableModel_Test : public QAbstractTableModel {Q_OBJECT public:QTableModel_Test(Q…...

编程日记 2025/9/5 19:55:17

2025.3.19

1、用vim编辑/etc/hosts文件，将本机和第二个虚拟机的ip地址和主机名写入该文件，然后ping 两个主机的主机名能否ping通； （1）在第一个虚拟机编辑/etc/hosts: 首先使用hostname、hostnamectl、hostname -f指令查看主机名…...

编程日记 2025/9/5 19:55:12

GATT（Generic Attribute Profile）是蓝牙低功耗（Bluetooth Low Energy，简称BLE）协议栈中的一个核心协议

蓝牙的 GATT（Generic Attribute Profile） 是蓝牙低功耗（Bluetooth Low Energy，简称BLE）协议栈中的一个核心协议，用于定义设备如何通过蓝牙进行数据传输和交互。GATT 是基于 ATT（Attribute Proto…...

编程日记 2025/9/5 19:55:06

打造下一代智能体验：交互型 AI 的崛起与实践

在人工智能技术不断飞跃的今天，我们正迎来一个从"一问一答"向"多轮交互、智能反馈"转变的新时代——交互型 AI（Interactive AI）。什么是交互型 AI？ 交互型 AI 指的是具备多轮对话能力、状态记忆、工具调用…...

编程日记 2025/9/5 19:55:02

关于uint8_t、uint16_t、uint32_t、uint64_t的区别与分析

一、类型定义与字节大小 uint8_t、uint16_t、uint32_t、uint64_t 是 C/C 中定义的无符号整数类型，通过 typedef 对基础类型起别名实现。位宽（bit）和字节数严格固定： uint8_t：8 位，占用 1 字节&#xff…...

编程日记 2025/9/5 19:54:55

19685 握手问题

19685 握手问题 ⭐️难度：简单 🌟考点：2024、省赛、数学 📖 📚 package test ;import java.util.Scanner; public class Main {public static void main(String[] args) {Scanner scanner new Scanner(System.in);…...

编程日记 2025/9/5 19:54:51

react redux的学习，单个reducer

redux系列文章目录一什么redux？ redux是一个专门用于做状态管理的JS库(不是react插件库)。它可以用在react, angular, vue等项目中, 但基本与react配合使用。集中式管理react应用中多个组件共享的状简单来说，就是存储页面的状态值的一个库&#xf…...

编程日记 2025/9/5 15:02:50

CCF GESP C++编程二级认证真题 2025年3月

C 二级 2025 年 03 月 CCF GESP C编程二级认证真题题号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 答案 D C A A D A D A C B C D B C C 1 单选题第 1 题 2025年春节有两件轰动全球的事件，一个是DeepSeek横空出世，另一个是贺岁片《哪吒2》票房惊人&#…...

编程日记 2025/9/5 19:54:41

Lua函数与表+Lua子文件加载与元表

Lua函数相关示例代码 --脚本型语言，不能先调用，再定义，因为代码是从上往下执行的 --第一种声明函数 function func1()print("这是func1") end--先定义，再调用，没有问题 func1() -------------------------…...

编程日记 2025/9/5 19:54:35

Linux systemd 服务全面详解

一、systemd 是什么？ systemd 是 Linux 系统的现代初始化系统（init）和服务管理器，替代传统的 SysVinit 和 Upstart。它不仅是系统启动的“总指挥”，还统一管理服务、日志、设备挂载、定时任务等。核心作用服务管理…...

编程日记 2025/9/5 9:57:42

Linux系统调用编程

目录 1.Linux下进程和线程进程线程区别查看进程pid终止进程pid 2.Linux虚拟内存管理与stm32内存映射设计目标与架构差异地址空间管理机制对比内存使用与性能特性 3.Linux系统调用函数fork()wait()exec() 4.树莓派环境下练习创建账号1创建用户账号2.配置用户权限3.查看用户登录…...

编程日记 2025/9/5 19:54:22

AWS Langfuse AI用Bedrock模型使用完全教程

AWS Langfuse AI使用完全教程推荐超级课程：本地离线DeepSeek AI方案部署实战教程【完全版】Docker快速入门到精通Kubernetes入门到大师通关课AWS云服务快速入门实战目录 AWS Langfuse AI使用完全教程Langfuse是什么？准备工作创建Langfuse账户1.创建LLM应用程序启用Bedrock…...

编程日记 2025/9/5 19:32:41

【Docker项目实战】使用Docker部署MediaCMS内容管理系统

【Docker项目实战】使用Docker部署MediaCMS内容管理系统前言一、MediaCMS介绍1.1 MediaCMS 简介1.2 主要特点1.3 使用场景二、本次实践规划2.1 本地环境规划2.2 本次实践介绍三、本地环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本四、下载Med…...

编程日记 2025/9/5 19:54:12

OpenHarmony子系统开发 - DFX（一）

OpenHarmony子系统开发 - DFX（一） 一、DFX概述简介在OpenHarmony中，DFX(Design for X)是为了提升质量属性的软件设计，目前包含的内容主要有：DFR（Design for Reliability，可靠性&#xff09…...

编程日记 2025/9/5 13:39:30

深入解析：使用Python爬取Bilibili视频

深入解析：使用Python爬取Bilibili视频引言 Bilibili，作为中国领先的年轻人文化社区，拥有海量的视频资源。对于想要下载Bilibili视频的用户来说，手动下载不仅费时费力，而且效率低下。本文将介绍如何使用Python编写一…...

编程日记 2025/9/5 19:54:00

详解数据结构线性表 c++实现

线性表线性表是一种非常基础且重要的数据结构，它是具有相同数据类型的 n（n≥0）个数据元素的有限序列。这里的 “有限” 意味着元素的数量是确定的，“序列” 则表示元素之间存在着顺序关系。顺序表顺序表是线性表的一种顺序存…...

编程日记 2025/9/5 19:53:55

Prolog语言的网络协议栈

Prolog语言的网络协议栈引言网络协议栈是现代计算机网络的重要组成部分，它负责在网络中的各个节点之间以标准化的方式传输数据。在这一体系中，不同层次的协议相互协作，以实现从物理传输到应用层数据处理的功能。Prolog是一种以符号逻辑为…...

编程日记 2025/9/5 19:53:50

音视频基础（音频常用概念）

文章目录 **1. 比特率（Bitrate）****概念****影响****音频比特率****视频比特率** **2. 码率（Bitrate）****3. 帧（Frame）****概念****视频帧****音频帧** **4. 帧长（Frame Length）****…...

编程日记 2025/9/5 19:53:45

洛谷题单3-P5725 【深基4.习8】求三角形-python-流程图重构

题目描述模仿例题，打印出不同方向的正方形，然后打印三角形矩阵。中间有个空行。输入格式输入矩阵的规模，不超过 9 9 9。输出格式输出矩形和正方形输入输出样例输入 4输出 01020304 05060708 09101112 13141516010203040506 …...

编程日记 2025/9/5 19:53:40

【数据结构】邻接表 vs 邻接矩阵：5大核心优势解析与稀疏图存储优化指南

邻接表法导读一、邻接矩阵的不足邻接表二、存储结构三、算法评价3.1 时间复杂度3.2 空间复杂度四、邻接表特点4.1 特点解读特点3特点4特点5 结语导读大家好，很高兴又和大家见面啦！！！ 图作为一种复杂的数据结构，其…...

编程日记 2025/9/5 19:53:35

编程能力的跃迁时刻：技术革命与认知重构的交响曲

在软件开发领域，从业者常将"一万小时定律"视为能力增长的圭臬，但真正的能力跃迁往往发生在特定技术范式转换的临界点。当开发者首次理解递归算法的本质，当面向对象编程替代过程式思维，当自动化工具链重塑开发流程，这些认知地震时刻往往成为技术生涯的分水岭。 …...

编程日记 2025/9/5 19:53:30

PostIn V1.0.8版本发布，IDEA 插件支持一键扫描上报，让接口定义不再繁琐

PostIn是一款国产开源免费的接口管理工具，包含项目管理、接口调试、接口文档设计、接口数据MOCK等模块，支持常见的HTTP协议、websocket协议等，支持免登陆本地接口调试，同时可以对项目进行灵活的成员权限、消息通知管理等。本周Pos…...

编程日记 2025/9/5 19:53:24

删除Linux服务器上多余的系统启动项，并重装Ubuntu系统

问题描述 2024年6月，Centos团队终止维护Centos7系统，Ubuntu成了我的替换方案。正好有一台闲置的服务器，于是我临危受命给这台服务器重装系统。经过我一番研究，Ubuntu系统初步安装成功了，但是存在一大堆问题&#xff…...

编程日记 2025/9/5 19:53:19

在亚马逊云科技上使用n8n快速构建个人AI NEWS助理

前言： N8n 是一个强大的工作流自动化工具，它允许您连接不同的应用程序、服务和系统，以创建自动化工作流程，并且采用了开源MIT协议，可以放心使用，他的官方网站也提供了很多的工作流，大家有兴趣的…...

编程日记 2025/9/5 19:53:13

JSON介绍及使用

1.JSON 1.JSON简介 JSON（JavaScript Object Notation）是一种轻量级的数据序列化协议，基于文本，完全独立于语言。 JSON由键值对组成，支持以下几种数据类型： 字符串：用双引号括起来的文本。数…...

编程日记 2025/9/5 4:27:31

AOP 的织入过程是怎样的？

AOP（面向切面编程）的织入（Weaving）是将切面（Aspect）应用到目标对象（Target Object）并创建代理对象（Proxy Object）的过程。这个过程可以发生在不同的阶段&…...

编程日记 2025/9/5 19:53:03