Golang 生产开发常用工具

h, _ := holmes.New(
    holmes.WithCollectInterval("5s"), // 每5秒检查一次
    holmes.WithDumpPath("/tmp"),      // 结果存哪里
    
    // 配置规则：当 CPU > 80% 时，抓取 CPU Profile
    holmes.WithCPUDump(80, 25, 80, time.Minute),
    
    // 配置规则：当 Goroutine > 10000 时，抓取 Goroutine Stack
    holmes.WithGoroutineDump(10000, 25, 20000, time.Minute),
)
h.Enable()
h.Start()

func main() {
	// 1. 初始化 Upgrader
	upg, err := tableflip.New(tableflip.Options{})
	if err != nil {
		log.Fatal("初始化失败:", err)
	}
	defer upg.Stop()

	// 2. 监听 SIGHUP 信号来触发升级操作
	go func() {
		sig := make(chan os.Signal, 1)
		signal.Notify(sig, syscall.SIGHUP)
		for range sig {
			// 核心步骤：Fork 新进程并传递文件描述符
			if err := upg.Upgrade(); err != nil {
				log.Println("升级失败:", err)
			}
		}
	}()

	// 3. 获取监听器 (如果是升级，这里会直接拿到旧进程传过来的 Socket)
	ln, err := upg.Fds.Listen("tcp", ":8080")
	if err != nil {
		log.Fatal("监听失败:", err)
	}

	server := &http.Server{
		Handler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
			fmt.Fprintf(w, "我是进程 PID: %d\n", os.Getpid())
		}),
	}

	// 4. 启动服务
	go func() {
		if err := server.Serve(ln); err != http.ErrServerClosed {
			log.Println("服务错误:", err)
		}
	}()

	// 5. 关键：告诉父进程“我已经启动并准备好接客了”，父进程随后会开始退出流程
	if err := upg.Ready(); err != nil {
		log.Fatal("Ready 通知失败:", err)
	}

	// 6. 阻塞等待退出信号 (当新的子进程调用 Ready 后，本进程会收到这里的信号)
	<-upg.Exit()

	// 7. 优雅关闭：处理完当前正在进行的请求后再退出
	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
	defer cancel()
	server.Shutdown(ctx)
}

// 1. 创建一个新的 cron 实例，默认支持 5 个字段 (分 时 日 月 周)
// 如果需要精确到秒，可以使用 cron.New(cron.WithSeconds())
c := cron.New()

// 2. 添加定时任务
// 示例 A: 每分钟执行一次
_, err := c.AddFunc("* * * * *", func() {
    fmt.Println("[Info] 每分钟任务执行:", time.Now().Format("15:04:05"))
})

// 示例 B: 每天上午 10:30 执行
c.AddFunc("30 10 * * *", func() {
    fmt.Println("[Job] 日报生成任务开始…")
})

// 示例 C: 每隔 5 秒执行一次 (使用特殊描述符)
c.AddFunc("@every 5s", func() {
    fmt.Println("[Tick] 5秒心跳检测")
})

// 3. 启动调度器
// 注意：Start() 会启动一个新的 goroutine，不会阻塞当前线程
c.Start()
fmt.Println("Cron 调度器已启动…")

# 安装 swag 命令行工具
go install github.com/swaggo/swag/cmd/swag@latest

# 下载 gin-swagger 适配库
go get -u github.com/swaggo/gin-swagger
go get -u github.com/swaggo/files

// @title           我的 Gin API 文档
// @version         1.0
// @description     这是一个基于 Gin 的示例 API 服务
// @termsOfService  http://swagger.io/terms/

// @contact.name    API Support
// @contact.url     http://www.swagger.io/support
// @contact.email   support@swagger.io

// @host            localhost:8080
// @BasePath        /api/v1
func main() {
	r := Gin.Default()

	v1 := r.Group("/api/v1")
	{
		v1.GET("/users/:id", GetUser)
	}

	// 注册 Swagger 路由
	r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))

	r.Run(":8080")
}

// GetUser 获取用户信息
// @Summary      获取单个用户
// @Description  根据用户 ID 获取用户详细信息
// @Tags         User
// @Accept       json
// @Produce      json
// @Param        id   path      int  true  "User ID"
// @Success      200  {object}  map[string]interface{}
// @Router       /users/{id} [get]
func GetUser(c *gin.Context) {
	id := c.Param("id")
	c.JSON(200, gin.H{
		"id":   id,
		"name": "admin",
	})
}

// 安装 air，go get 主要作用是将模块加入 go.mod，go install 主要用于安装 cli 工具
go install github.com/air-verse/air@latest
// 生成默认配置文件
air init
// 使用
air

# .air.toml
[build]
cmd = "go build -o ./tmp/main ./main.go"  # 指定构建命令，产出你要执行的 ./main
bin = "./tmp/main"                        # air 会运行这个二进制文件
full_bin = true                           # 使用完整路径（不加的话在某些环境变量下会找不到）

[run]
cmd = ""                                  # 不加的话 air 会自动运行上面 build 出来的 bin

[log]
time = true

go install github.com/boyter/scc/v3@latest # 安装命令
scc .          # 统计当前目录全部代码