如何在Go的conn包中兼容db/pkg.v3与v4版本编译？

首先直接回答你的第一个问题：直接在conn包中通过编译时选择引入pkg.v3或pkg.v4是不可行的。Go的import语句是静态解析的，编译阶段无法动态替换不同版本的包路径——哪怕两个包的接口几乎一致，编译器也会把它们当作完全不同的包处理，没法直接切换。

不过你提到的「创建本地中间pkg包」的思路非常可行，而且能完全保持conn包的代码不变。下面是具体的实现方案：

步骤1：创建本地中间pkg包 #

在你的项目中新建一个pkg目录（名字可以自定义，比如dbadapter），作为连接conn包和第三方数据库包的中间层。这个包的核心作用是统一对外暴露接口，内部通过构建标签切换底层依赖的v3/v4版本。

目录结构 #

your-project/
├── conn/
│   └── conn.go   // 原有的conn包代码，后续无需修改
├── pkg/          // 新建的中间层包
│   ├── pkg.go    // 定义公共接口和类型
│   ├── pkg_v3.go // 绑定pkg.v3的实现（带dbv3构建标签）
│   ├── pkg_v4.go // 绑定pkg.v4的实现（带dbv4构建标签）
│   └── go.mod    // 中间层包的依赖声明
└── go.mod

步骤2：定义公共接口（pkg.go） #

在pkg.go中定义conn包需要用到的所有公共接口，确保这些接口能同时兼容pkg.v3和pkg.v4的功能：

package pkg

// DB 定义conn包依赖的数据库操作接口，覆盖所有共用方法
type DB interface {
    Query(sql string, args ...interface{}) (Rows, error)
    Exec(sql string, args ...interface{}) (Result, error)
    Close() error
    // 添加conn包用到的其他方法
}

// Rows 封装数据库查询结果的接口
type Rows interface {
    Next() bool
    Scan(dest ...interface{}) error
    Close() error
}

// Result 封装执行结果的接口
type Result interface {
    LastInsertId() (int64, error)
    RowsAffected() (int64, error)
}

// New 对外暴露的实例创建函数，由不同版本的文件实现
func New() DB

步骤3：实现v3版本绑定（pkg_v3.go） #

给这个文件加上dbv3构建标签，内部引入pkg.v3并实现公共接口：

//go:build dbv3
// +build dbv3

package pkg

import "gopkg.in/db/pkg.v3"

// dbImpl 包装pkg.v3的DB实例
type dbImpl struct {
    inner *dbpkg.DB
}

// 实现DB接口的所有方法，转发到底层pkg.v3实例
func (d *dbImpl) Query(sql string, args ...interface{}) (Rows, error) {
    return d.inner.Query(sql, args...)
}

func (d *dbImpl) Exec(sql string, args ...interface{}) (Result, error) {
    return d.inner.Exec(sql, args...)
}

func (d *dbImpl) Close() error {
    return d.inner.Close()
}

// New 创建pkg.v3版本的DB实例
func New() DB {
    return &dbImpl{inner: dbpkg.New()}
}

步骤4：实现v4版本绑定（pkg_v4.go） #

同理，给这个文件加上dbv4构建标签，内部引入pkg.v4并实现相同的公共接口：

//go:build dbv4
// +build dbv4

package pkg

import "gopkg.in/db/pkg.v4"

type dbImpl struct {
    inner *dbpkg.DB
}

func (d *dbImpl) Query(sql string, args ...interface{}) (Rows, error) {
    return d.inner.Query(sql, args...)
}

func (d *dbImpl) Exec(sql string, args ...interface{}) (Result, error) {
    return d.inner.Exec(sql, args...)
}

func (d *dbImpl) Close() error {
    return d.inner.Close()
}

func New() DB {
    return &dbImpl{inner: dbpkg.New()}
}

步骤5：修改conn包的依赖 #

把conn中原有的gopkg.in/db/pkg.v3 import替换为你的本地中间pkg包：

// conn/conn.go
import "your-project/pkg" // 替换为实际的模块路径

func connect() {
    y := pkg.New()
    // 后续调用y的方法和之前完全一致，无需修改任何业务逻辑
    ...
}

步骤6：编译时切换版本 #

通过-tags参数指定编译标签，就能选择使用v3还是v4版本：

• 编译旧版数据库版本：go build -tags dbv3
• 编译新版数据库版本：go build -tags dbv4

额外优化小技巧 #

如果pkg.v3和pkg.v4的函数签名完全一致，你甚至可以不用写接口转发，直接在版本文件中导出与第三方包同名的函数：

// pkg_v3.go
//go:build dbv3
package pkg

import dbv3 "gopkg.in/db/pkg.v3"

var New = dbv3.New
var Query = dbv3.Query
// 其他需要的函数直接赋值

这种方式更简洁，但只适用于函数/方法签名完全无差异的场景，接口方式的兼容性更强，推荐优先使用。

内容的提问来源于stack exchange，提问作者J Aamish