Debian 中 Go 语言如何与数据库交互

Ivy

发布时间：2026-08-23 | 60人浏览过

原创

前言

在 Debian 上让 Go 程序连上数据库，看起来只是“装环境、装驱动、写代码”三步，但实际最容易卡住的往往是路径配置、驱动对应关系和连接参数。本文按安装、配置、驱动选择到查询验证的顺序重写一遍流程，并保留可直接运行的示例代码，方便你快速定位问题到底出在环境、数据库服务，还是查询结果处理。

在 Debian 上用 Go 访问数据库，核心并不复杂，难点主要集中在环境变量、驱动选择和连接信息是否写对。下面按照“先装环境、再装驱动、最后写代码并验证”的顺序梳理一遍，读完后你可以快速判断自己卡在安装、连接还是查询结果处理这一步。

在 Debian 上安装 Go 环境

如果系统里还没有 Go，可以先更新软件索引，再直接安装发行版提供的 golang-go 包：

sudo apt update
sudo apt install golang-go

这一步完成后，系统就具备了运行和编译 Go 程序的基础环境。后续要连接数据库，还需要把工作目录和可执行路径配置好。

配置 GOROOT、GOPATH 和 PATH

Go 程序能否顺利找到工具链和工作空间，通常取决于 GOROOT、GOPATH 以及 PATH 是否正确。常见做法是把下面几行加入 ~/.bashrc 或 ~/.profile：

Go 在 Debian 上连接数据库的准备流程图 — **Debian 上 Go 环境准备流程**用流程图梳理 Debian 上从安装 Go 到环境变量生效的关键步骤。

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

写入后执行下面的命令让配置立即生效：

source ~/.bashrc

或者：

source ~/.profile

这里可以顺手理解一下两者的作用：GOROOT 指向 Go 安装位置，GOPATH 主要用于你的工作空间，而 PATH 则决定终端能否直接找到 go 命令及相关工具。

按数据库类型安装对应驱动

Go 标准库里的 database/sql 提供的是通用接口，真正连接哪种数据库，还要安装对应驱动。不同数据库的命令不同，直接按你的目标类型选择即可。

MySQL 驱动

go get -u github.com/go-sql-driver/mysql

PostgreSQL 驱动

go get -u github.com/lib/pq

SQLite 驱动

go get -u modernc.org/sqlite

如果你只是想先把流程跑通，通常可以先选自己最熟悉的数据库；若按本文示例直接测试，则使用的是 MySQL 驱动。

编写 Go 数据库连接与查询示例

环境和驱动准备好之后，就可以新建一个 main.go，用 database/sql 完成连接、连通性检查和查询。下面这段代码保留了最基础的完整流程，适合先确认“能不能连上”和“能不能读出结果”：

Go 数据库驱动选择与示例查询结构图 — **Go 连接数据库示例的 4 个关键环节**把驱动选择、DSN、连接测试和结果遍历拆成四个结构块，帮助读者快速理解示例代码在做什么。

package main

import (
    "database/sql"
    "fmt"
    _ "github.com/go-sql-driver/mysql"
)

func main() {
    // 连接数据库
    dsn := "user:password@tcp(localhost:3306)/dbname"
    db, err := sql.Open("mysql", dsn)
    if err != nil {
        panic(err.Error())
    }
    defer db.Close()

    // 测试连接
    err = db.Ping()
    if err != nil {
        panic(err.Error())
    }
    fmt.Println("Connected to the database!")

    // 执行查询
    rows, err := db.Query("SELECT id, name FROM users")
    if err != nil {
        panic(err.Error())
    }
    defer rows.Close()

    // 遍历结果集
    for rows.Next() {
        var id int
        var name string
        err = rows.Scan(&id, &name)
        if err != nil {
            panic(err.Error())
        }
        fmt.Printf("ID: %d, Name: %s\n", id, name)
    }

    // 检查遍历时是否有错误
    if err = rows.Err(); err != nil {
        panic(err.Error())
    }
}

这段示例里有几个关键点：

sql.Open("mysql", dsn) 负责初始化连接信息，其中 dsn 里的用户名、密码、主机、端口和库名都需要替换成你的实际配置。
db.Ping() 用来确认数据库当前可达，能把很多连接参数错误提前暴露出来。
db.Query("SELECT id, name FROM users") 用于执行查询，随后通过 rows.Next() 和 rows.Scan() 逐行读取结果。
最后的 rows.Err() 不要省略，它可以补充捕获遍历结果集期间发生的错误。