【基于GO的Web开发11】gin获取URL‑Path 路径参数

一、什么是 Path 路径参数

路径参数(也叫 URL 路径参数、占位符参数),参数直接放在 URL 路径中,使用 / 进行分割 ,不是放在?后面。

示例地址:

复制代码
http://127.0.0.1:9090/blog/2026/08
  • /blog:固定路由前缀
  • 2026:year 路径参数
  • 08:month 路径参数

适用场景:博客文章年月、用户 id、资源详情页等 REST 风格接口。

二、基础语法

1. 路由定义规则

使用 :参数名 作为占位符

Go 复制代码
r.GET("/blog/:year/:month", func(c *gin.Context) {

})

:year、:month 就是路径占位符

2. 获取路径参数

Go 复制代码
变量 := c.Param("参数名")

⚠️注意:c.Param() 获取到的值永远是 string 字符串类型,如果需要数字,要手动转换为 int。

三、完整代码示例

Go 复制代码
package main

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

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

	// 定义带路径参数的路由
	r.GET("/blog/:year/:month", func(c *gin.Context) {
		// 获取路径参数
		year := c.Param("year")
		month := c.Param("month")

		// 返回JSON响应
		c.JSON(http.StatusOK, gin.H{
			"year":  year,
			"month": month,
		})
	})

	r.Run(":9090")
}

浏览器测试访问地址

复制代码
http://127.0.0.1:9090/blog/2026/08

返回结果:

Go 复制代码
{"month":"08","year":"2026"}

四、多组路径参数(防止路由冲突)

多条带占位符的路由,固定前缀不一样就不会冲突

Go 复制代码
// 用户路由
r.GET("/user/:name/:age", func(c *gin.Context) {
	name := c.Param("name")
	age := c.Param("age")
	c.JSON(http.StatusOK, gin.H{
		"name": name,
		"age":  age,
	})
})

// 博客路由
r.GET("/blog/:year/:month", func(c *gin.Context) {
	year := c.Param("year")
	month := c.Param("month")
	c.JSON(http.StatusOK, gin.H{
		"year":  year,
		"month": month,
	})
})

路由冲突坑点: /user/:name 和 /:name 就会发生冲突,Gin 优先匹配先注册的路由。

五、路径参数核心特点 & 易错点总结

  1. 参数放在 URL 路径,由/分割,不带?
  2. 获取函数:c.Param("key")
  3. 返回值固定为字符串 string
  4. 路径参数必填,不能省略,少一段路径就直接 404
  5. 路由前缀不一样,多条带占位符路由不会冲突

六、Gin 三种传参方式对比(复习联动)

表格

参数类型 获取方法 示例 URL
Form 表单 POST 参数 c.PostForm() 表单提交 /login
Path 路径参数 c.Param() /blog/2026/08
Query 查询参数 c.Query() /info?id=1&name=zs
相关推荐
翼帆23 分钟前
我用 AI 复刻了 CodeTank,重温代码坦克
前端·javascript·开源·ai编程·游戏开发·codetank
考虑考虑23 分钟前
zookeeper认证
后端·zookeeper
有趣的老凌25 分钟前
学习MarkDown笔记
前端
掘金者阿豪42 分钟前
数据库选型到底应该看什么?从业务需求到技术架构的实践分析
前端·后端
苍何1 小时前
豆包终于想通了...
后端
AAA修煤气灶刘哥2 小时前
Agent 都能干活了,软件还需要那么多按钮吗?
人工智能·后端·架构
未秃头的程序猿2 小时前
给新模块加了个 @MapperScan,启动崩了,最后发现跟 MapperScan 没关系
java·后端·mybatis
苍何2 小时前
不用 Opus5.5 ,即梦也能出爆款 vibe 视频了
后端
徐小夕2 小时前
万字拆解:零向量库、无模型微调,SAG2 凭什么刷新多跳问答 SOTA
前端·vue.js·github
SimonKing2 小时前
WorkBuddy又推出新的限免模型(Hy4 flash)了,羊毛可以薅起来了
java·后端·程序员