Golang Go语言中gin官方文档示例代码变量命名为何用单个单词
Golang Go语言中gin官方文档示例代码变量命名为何用单个单词
package main
import “github.com/gin-gonic/gin”
func main() {
r := gin.Default()
r.GET("/ping", func(c *gin.Context) {
c.JSON(200, gin.H{
“message”: “pong”,
})
})
r.Run() // listen and serve on 0.0.0.0:8080
}
其中
r := gin.Default()
改成
router := gin.Default()
是不是更有助于理解呢
更多关于Golang Go语言中gin官方文档示例代码变量命名为何用单个单词的实战教程也可以访问 https://www.itying.com/category-94-b0.html
r 也能理解
更多关于Golang Go语言中gin官方文档示例代码变量命名为何用单个单词的实战系列教程也可以访问 https://www.itying.com/category-94-b0.html
#1 <br>func router01() http.Handler {<br> e := gin.New()<br> e.Use(gin.Recovery())<br> e.GET("/", func(c *gin.Context) {<br> c.JSON(<br> http.StatusOK,<br> gin.H{<br> "code": http.StatusOK,<br> "error": "Welcome server 01",<br> },<br> )<br> })<br><br> return e<br>}<br>
像这个 e:= gin.New() 呢 
golang 官方问题推崇的风格就是这样，循环啥的小作用域都用单变量，反正代表外部不用太关心这个变量。其实这里的 main 函数也是一样。你就是创建一个 router 然后注册对应的 handler 。这个事实也没什么关系，又不用传到别的地方去
临时变量 a b c
输入数据 d (data)
标记就用 f (flag)
全局变量 g (global) ( flask: hhh)
定义矩形 h w 或者 m n
长度肯定 l
遍历下标 i j k
字典遍历 k v
字符串 s
时间 t
三维数组 x y z
双指针就 l r 或 s e 或者 h l 或 h t （ left right / start end / high low / head tail ）
多个临时变量就 a1 a2 a3 aa bb cc
debug 临时变量 wtf cnm mmp why
恐怕问题不在变量 r，而是在 API gin.Default 上，听过没用过 gin 的根本不知道 Default 返回值是什么。
r := gin.DefaultRouter() 这样是不是就比较容易懂了？（没看过 gin 源码，姑且认为返回的是叫 Router 的东西）
给几个我觉得不错的 API 命名供参考：
net/http.DefaultServeMux
github.com/go-chi/chi.NewRouter()
github.com/gorilla/mux.NewRouter()
确实这样改了之后更清晰。不过鉴于现代化 IDE/编辑器已经很普及了（根据 Go 官方调查，绝大部分人都用 vscode 和 goland ），可轻松查看类型，所以不改问题也不大，改了更好。
#10 计数用 c，累加用 s，累乘用 p 或者 q，文件名 fn，打开的文件 fp
长度可能是 n （ NOIP 一堆长度为 n，因为大 O 基本都是 n ），第二个长度就是 m
四维数组 wxyz
uv mapping，连专业术语都是随便找的字母
我的回复只是说明 gin 框架没有按照 go 官方推荐的方式组织代码，按我的设想，应该用 NewRouter，DefaultRouter 等含义更清晰的函数名。详细解释如下：
按 go 的官方规范，有区分度的结构体应该是由最后一层 package + struct name 组成。举例如下： http.Router, rpc.Request, websocket.Message, router.New(), mux.Default() （其中一些是现编的）等，还有上面有人提到的 gin.Middleware, gin.Engine （虽然不知道 Engine 具体是什么，但可以猜测是某种实体）。
而 gin.New(), gin.Default() 等的返回值是什么？参照对 router.New(), message.New() （分别返回 Router / Message ）等的理解，应该是返回一个叫「 Gin 」的东西，而 Gin 是什么呢？我的理解是一个框架，框架名作为实体？这样的代码读起来就很困惑了。
问题出在哪呢？ New / Default 不带有任何实体标识符，而实体由 package + structname 确定，既然不能用 struct name 来表示类型， 那就应该用 package 的最后一层来表示了。但 gin 这里没有，导致了一部分人对 gin.New(), gin.Default() 这样的代码不明所以。
如果 go 官方代码有最后一层 package + struct name 仍然定义不清晰的，欢迎打脸。
https://blog.golang.org/package-names 「 Go code is organized into packages. Within a package, code can refer to any identifier (name) defined within, while clients of the package may only reference the package’s exported types, functions, constants, and variables. Such references always include the package name as a prefix: foo.Bar refers to the exported name Bar in the imported package named foo.」
在Golang（又称Go语言）中，gin框架的官方文档示例代码倾向于使用单个单词作为变量名，这一做法有其特定的原因和优势，主要体现在以下几个方面：
-
简洁明了：单个单词的变量名通常更加简洁，能够快速传达变量的用途或类型，便于阅读和理解代码。
-
一致性：在官方文档中，使用统一的命名风格（如单个单词）有助于保持代码示例的一致性，降低读者的认知负担。
-
遵循惯例：Go语言社区普遍倡导简洁、直接的命名方式，单个单词的变量名符合这一惯例，有助于代码风格的统一。
-
避免命名冲突：在较短的代码示例中，使用单个单词的变量名可以减少命名冲突的可能性，使得代码更加紧凑和易于维护。
-
便于复制粘贴：对于初学者或需要快速上手gin框架的开发者来说，简洁的变量名使得示例代码更加便于复制粘贴和修改，以适应具体的应用场景。
当然，在实际项目中，变量名的选择应根据具体情况而定。对于复杂逻辑或关键变量，使用更具描述性的命名（可能是多个单词组成的短语）可能会更加合适。但在gin官方文档这样的示例代码中，为了保持简洁性和易读性，使用单个单词作为变量名是一个合理的选择。
