Jacin Blog

Go 开发

分类下的全部文章

Go 开发
2 分钟

Cursor 配置 Go debug 模式

这份速查记录聚焦在 Cursor 中为 Go 项目启用调试模式，配置入口是项目目录下的 .vscode/launch.json。正文给出两套可直接复制的 launch 配置：第一套使用 type 为 go、request 为 launch、mode 为 auto，并将 program 设置为 ${fileDirname}，适合从当前文件所在目录快速启动，也提示可改为 workspace 下的 main.go 或 cmd/server 等入口目录。第二套配置将 mode 显式改为 debug，以 ${workspaceFolder}/main.go 作为程序入口，同时设置 cwd、dlvToolPath、环境变量、showLog 和 verbose trace，便于在开发环境中固定调试参数并输出更详细的 Delve 日志。需要注意的是，示例里的 dlvToolPath 使用了本机绝对路径，迁移到其他机器或团队项目时应按实际安装位置调整；环境变量如 GIN_MODE、GOPROXY、GOEXPERIMENT 也应与项目运行要求匹配。它适合已经具备 Go、Cursor/VS Code Go 调试支持和 dlv 基础环境的开发者，用来快速搭建单入口项目或当前目录入口的调试配置。

Go 开发
9 分钟

go channel用法

这篇笔记围绕 Go 的 channel 基础用法展开，定位为 goroutine 之间传递数据的类型安全管道，并借 CSP 思想说明为什么 Go 鼓励用通信来协调并发，而不是让多个 goroutine 直接共享同一份内存。内容重点解释 channel 的类型化、同步阻塞、可选缓冲区和 close 后接收零值及状态标志等特性，并给出任务分发、信号通知、并发控制等常见使用场景。文章用 go func() 发送字符串的例子说明无缓冲通道的核心约束：发送和接收必须并发配对，若在同一个顺序执行流中先发送再接收，程序会停在发送语句并形成死锁。随后通过 make(chan string) 与 make(chan string, 1) 的对比，区分无缓冲通道“零容量、必须当场交付”和缓冲通道“容量未满即可暂存”的行为差异，也说明并非所有 channel 操作都必须额外启动 goroutine。最后，笔记把普通 int 变量和 chan int 放在并发语境下比较，强调变量只是存值，而 channel 用于跨 goroutine 传值、同步生产者与消费者，并减少手写锁和时序控制的复杂度，适合刚开始理解 Go 并发模型和阻塞语义的读者。

Go 开发
7 分钟

go 里面的指针

这篇笔记围绕 Go 语言中的指针基础展开，先用 `a := 10`、`p := &a` 和 `*p` 说明指针就是变量的内存地址，`&` 用于取地址，`*` 用于通过地址访问或修改值。内容重点澄清 Go 与 C 在指针上的差异：Go 可以声明 `*int` 这类指针类型，但不支持指针算术，不能随意转换指针类型，复杂的多级指针也不鼓励使用，内存分配由 `new`、`make` 和 GC 机制配合完成。文章通过 `modify(x *int)` 的例子解释函数修改外部变量的过程：传入的是 `&a` 这个地址值，函数参数仍然按值接收，只是可以通过解引用修改地址指向的原始数据。结构体指针部分展示了 `p.Name` 与 `(*p).Name` 的等价关系，说明 Go 会在访问结构体字段时自动解引用，以减少样板代码。笔记还提醒切片、map、channel 等内置类型本身具有引用语义，通常不需要再显式传指针。最后，它集中纠正了“Go 是引用传递”“new 和 make 一样”“指针越多越高效”等常见误区，适合正在从 C、JavaScript 或其他语言迁移到 Go、需要理解值传递与可变性控制的初学者。

Go 开发
10 分钟

gorm配置数据库

这份笔记面向 Go Web 项目中使用 GORM 接入数据库的基础配置场景，以 PostgreSQL 为例展示了将连接初始化放在 infra 目录下的组织方式。正文先概括 GORM 作为 ORM 的常见能力，包括多数据库支持、自动迁移、事务、预加载、钩子、软删除和自定义 SQL，并给出安装 gorm 与数据库驱动的命令。配置部分围绕 InitPG 展开：从 utils.AppConfig 读取主机、用户、密码、库名和端口拼接 DSN，按开发环境开启 SQL Info 日志、生产环境静默日志，再通过 gorm.Open 建立连接并取得底层 sql.DB 设置连接池参数。文章还说明 main.go 中应在加载配置后调用 infra.InitPG，并用 defer infra.ClosePG 在应用退出时关闭连接，便于服务优雅释放资源。关于 GetDB，重点澄清它只是返回全局保存的 *gorm.DB 指针，不会重复建连，也不会负责释放连接；多个请求并发调用是安全的，因为 GORM 的实例本身并不长期持有物理连接。真正执行 Find、First 等查询时，GORM 会从连接池临时借用连接并在完成后归还，但使用 Raw().Rows() 这类手动遍历结果集的写法必须显式 Close，否则可能持续占用连接池。整体适合正在搭建 Gin/GORM 项目骨架、需要理解连接池生命周期和全局 DB 访问方式的后端开发者。

Go 开发
8 分钟

docker部署 gin

这篇笔记聚焦 Gin 项目的 Docker 容器化部署，先从 Go 的部署特性解释为什么它适合做轻量镜像：Go 通过 go build 将源码、标准库和依赖静态链接为操作系统可直接执行的原生二进制文件，通常不需要在运行环境安装 Go、解释器或虚拟机。文章用 ELF、Mach-O、PE 等可执行文件格式说明二进制产物的本质，并对比 Go 与 C/C++ 在默认静态链接、交叉编译、标准库、并发和内存安全方面的差异，帮助读者理解“只拷贝可执行文件即可运行”的前提。部署部分给出多阶段 Dockerfile：先使用 golang:alpine 下载依赖并执行 go build -o gin-api-template，再切换到 alpine:latest，仅安装 ca-certificates，复制编译产物和 .env，暴露 8080 端口并以 CMD 启动程序。文章还解释 Alpine 镜像体积小、攻击面低、启动快以及基于 musl libc 和 busybox 的特点，说明为什么它常用于 Go 服务的运行阶段。最后的 docker-compose.yml 展示了构建当前目录镜像、映射 8080:8080、挂载并加载 .env、设置 unless-stopped 重启策略的基本方式，适合需要把 Gin API 打包成较小容器镜像并保持配置文件可管理的后端开发者。

Go 开发
16 分钟

gin 常见中间件配置

这篇笔记围绕 Gin API 项目的中间件基础配置展开，按 middlewares 目录下的 security.go、cors.go、request_id.go 和 logging.go 拆分说明安全响应头、跨域、请求标识与请求响应日志的实现方式。安全头部分展示了在 gin.HandlerFunc 中统一设置 X-Frame-Options、Content-Security-Policy、Referrer-Policy、Cross-Origin-Opener-Policy、X-Content-Type-Options、X-XSS-Protection，并仅在 HTTPS 或代理标记为 https 时启用 HSTS，用于降低 iframe 劫持、Referer 泄露和 MIME 嗅探等风险。CORS 配置通过应用配置读取允许来源，在开发环境回退到 localhost 与 127.0.0.1 白名单，同时明确允许方法、请求头、暴露 X-Request-ID、携带凭证和预检缓存时间。Request ID 中间件会优先复用请求头中的 X-Request-ID，没有则生成 UUID，并写入 Gin Context、工具包上下文和响应头，方便日志检索、链路追踪和前后端协同排查。日志中间件演示了读取并回填请求体、包装 ResponseWriter 捕获响应体、记录方法、路径、客户端 IP、User-Agent、状态码和耗时的做法。最后在 gin.New() 初始化的路由中给出注册顺序：Recovery、安全头、CORS、Request ID、日志，再挂载业务路由，适合作为 gin-api-template 的落地参考；但请求体和响应体日志会带来敏感信息暴露与性能开销，实际项目需要按场景裁剪。

Go 开发
11 分钟

gin框架-使用

这篇笔记围绕 Gin 框架的入门使用与并发模型展开，先定位它作为 Go 生态中轻量、高性能 Web 框架的用途，适合 RESTful API、微服务接口网关、后台管理系统和轻量级后端模块等场景。正文用一个 /ping 路由示例展示 Gin 启动 HTTP 服务、注册 GET 路由并返回 JSON 的最小写法，同时概括其中间件、参数绑定、错误处理、路由分组以及与 Swagger、JWT、Gorm、Zap 等库集成的常见能力。文章还把 Gin 放到容器化和云原生背景下理解，说明 Go 静态编译、二进制文件易分发、镜像可精简、启动快和适配 CI/CD 的特点，为什么与 Docker、Kubernetes 等基础设施生态契合。重点部分解释了 Gin“同步风格编程、goroutine 并发处理请求”的模型：业务代码看起来线性直观，但每个 HTTP 请求通常由独立 goroutine 承载，因此慢接口不会天然阻塞其他请求。最后通过 FastAPI 对比 async/await、事件循环、阻塞 IO、GIL 和协程调度差异，帮助读者判断 Go/Gin 与 Python/FastAPI 在易用性、吞吐和阻塞风险上的取舍。适合正在学习 Go 后端、准备做 API 服务或想理解 Gin 并发机制与容器化部署优势的开发者阅读。

go 环境搭建
Go 开发
9 分钟

go 环境搭建

这是一篇面向 Go 初学者的本地开发环境与项目结构入门笔记，覆盖从安装 Go、配置 GOROOT 与 PATH、验证 go version，到在 GoLand 中选择 SDK 的基础准备。正文重点解释 GOPATH 与 Go Modules 的差异：前者要求项目放在固定的 $GOPATH/src 下，依赖集中管理；后者通过 go.mod 在项目内独立管理依赖，是 Go 1.16 之后默认推荐的方式。文章以 Gin 小项目为例，演示 go mod init 创建模块、go get 显式添加依赖、go mod tidy 根据 import 自动整理依赖，并给出 main 包调用自定义 gin_test 包启动 /ping 接口的代码结构。后半部分补充 Go 的包与文件组织规则，说明同一目录同一 package 下多个 .go 文件会被编译器合并，函数重名会触发 redeclared 编译错误，并与 Python 的动态模块机制做了对照。文章还概括了 Go 用 struct、method、组合和接口替代传统 class 与继承的基本思路。最后介绍 air 热重载工具的安装、PATH 配置、air init 生成 .air.toml 以及运行 air 自动重启服务，适合从 Python 或其他动态语言转向 Go 的开发者建立环境、依赖和包组织的第一层认知。

Go 开发
1 分钟

关于“Go 开发”类别

“Go 开发”类别的定位应围绕分类准入规则展开，重点说明它为什么存在、用于承载哪些内容，以及作者在发布文章时如何判断是否归入该类。正文给出的框架强调，需要先解释类别用途，再界定它与站内既有类别的差异，避免同一主题在多个分类之间重复归档或被拆分得过细。适合纳入的内容应由类别说明进一步明确，例如语言相关实践、开发经验、工具链使用或问题处理等方向，但具体范围需要以实际站点分类体系为准。该说明还要求评估类别的必要性，判断它是否应独立保留，或是否可以与其他类别、子类别合并。整体价值在于为知识库分类提供一致的判断依据，使读者和作者都能更快理解该分类的边界、用途和内容预期。