如何在Golang中加载SQLite3的dylib扩展？（sqlite-vss实操问题）

问题根源 #

你碰到的两个问题原因很明确：

1. db.Exec(".load", ".vector0") 报错是因为.load是SQLite交互式shell的专属命令，Go的database/sql接口只支持标准SQL语句，不认这种shell指令。
2. 使用官方Go绑定出现sqlite_vector0未找到，是因为vss0依赖vector0扩展，必须先加载vector0，且扩展文件的路径没配置对。

可行解决方案 #

方法一：动态加载扩展（推荐新手用） #

Go里加载SQLite扩展得用load_extension SQL函数，推荐用modernc.org/sqlite库（比标准库对扩展支持更友好）：

1. 先安装依赖库：

go get modernc.org/sqlite

2. 写加载代码，注意替换成你的dylib实际路径：

package main

import (
    "context"
    "modernc.org/sqlite"
)

func main() {
    // 打开数据库
    db, err := sqlite.Open("your-db.db", sqlite.OpenReadWrite|sqlite.OpenCreate)
    if err != nil {
        panic(err)
    }
    defer db.Close()

    // 先加载vector0扩展，必须写绝对路径，或者把dylib扔到/usr/local/lib这类系统默认路径
    _, err = db.ExecContext(context.Background(), "SELECT load_extension('/绝对路径/vector0.dylib')")
    if err != nil {
        panic(err)
    }

    // 再加载vss0扩展
    _, err = db.ExecContext(context.Background(), "SELECT load_extension('/绝对路径/vss0.dylib')")
    if err != nil {
        panic(err)
    }

    // 验证是否加载成功，创建一个vss0虚拟表试试
    _, err = db.ExecContext(context.Background(), "CREATE VIRTUAL TABLE IF NOT EXISTS items USING vss0(content_embedding(384))")
    if err != nil {
        panic(err)
    }
}

方法二：静态编译扩展到Go程序 #

如果想把扩展直接打包进程序，不用带额外dylib，得自己编译sqlite-vss的静态库：

1. 确保本地有Clang/LLVM编译环境（macOS装Xcode Command Line Tools就行）。
2. 克隆sqlite-vss仓库到本地，进入仓库目录后执行编译：

make static

3. 在Go项目里通过CGO链接静态库，代码示例：

package main

/*
#cgo LDFLAGS: -L/你的sqlite-vss编译目录/build -lvss0 -lvector0 -lm -ldl
#include <sqlite3.h>
*/
import "C"
import (
    "database/sql"
    _ "github.com/mattn/go-sqlite3"
)

func main() {
    // 打开数据库，注意加上_allow_extensions=1参数
    db, err := sql.Open("sqlite3", "your-db.db?_allow_extensions=1")
    if err != nil {
        panic(err)
    }
    defer db.Close()

    // 静态编译后不用手动load扩展，直接创建vss0表验证
    _, err = db.Exec("CREATE VIRTUAL TABLE IF NOT EXISTS items USING vss0(content_embedding(384))")
    if err != nil {
        panic(err)
    }
}

编译时要确保CGO开启：

CGO_ENABLED=1 go build

避坑提醒 #

• vector0和vss0的版本必须完全匹配，别混用不同版本的扩展文件。
• macOS上如果碰到“无法打开文件，因为无法验证开发者”的错误，用这个命令解除隔离：

xattr -d com.apple.quarantine /你的扩展路径/xxx.dylib

• 要是用github.com/mattn/go-sqlite3库动态加载，连接字符串必须加_allow_extensions=1参数，否则会禁止加载扩展。

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