Windows下如何将Rusqlite程序链接到自定义编译的SQLite？

针对你不想使用vcpkg，希望在Windows环境下将Rusqlite与自定义编译的SQLite库配合使用（支持静态/动态链接）的需求，以下是可行方案：

方案一：静态链接自定义SQLite库 #

步骤1：编译生成SQLite静态库 #

下载SQLite源码后，使用Visual Studio的C++编译工具链生成静态库sqlite3.lib：

1. 打开对应架构的Visual Studio命令提示符（如x64 Native Tools Command Prompt）
2. 执行编译命令：

   # 编译目标文件
   cl /c /O2 sqlite3.c
   # 生成静态库
   lib /OUT:sqlite3.lib sqlite3.obj
   

注意：如果需要启用SQLite扩展（如JSON1、FTS5），编译时需添加对应宏定义，例如cl /c /O2 /DSQLITE_ENABLE_JSON1 sqlite3.c

步骤2：配置Rusqlite静态链接 #

有两种方式指定自定义库：

• 方式A：通过.cargo/config.toml配置
  在项目根目录创建或修改.cargo/config.toml，添加对应架构的链接参数：

  [target.x86_64-pc-windows-msvc]
  rustflags = [
      "-L", "D:/path/to/your/sqlite/lib/folder", # 替换为你的sqlite3.lib所在目录
      "-l", "sqlite3",
  ]
  

  之后直接执行编译命令即可：

  cargo build --example persons --features modern-full
  

• 方式B：通过环境变量指定
  编译前设置环境变量，告诉Rusqlite使用静态链接的自定义库：

  SET SQLITE3_LIB_DIR=D:/path/to/your/sqlite/lib/folder
  SET SQLITE3_STATIC=1
  cargo build --example persons --features modern-full
  

方案二：动态链接自定义SQLite库 #

步骤1：编译生成SQLite动态库 #

同样使用Visual Studio工具链生成动态库sqlite3.dll和导入库sqlite3.lib：

1. 打开对应架构的Visual Studio命令提示符
2. 执行编译命令：

   # 编译目标文件，导出动态库符号
   cl /c /O2 /DSQLITE_API=__declspec(dllexport) sqlite3.c
   # 生成动态库和导入库
   link /DLL /OUT:sqlite3.dll sqlite3.obj
   

步骤2：配置Rusqlite动态链接 #

• 库路径配置：可以通过.cargo/config.toml指定导入库路径（同静态链接的.cargo/config.toml配置），或者将sqlite3.lib所在目录添加到系统LIB环境变量
• 运行时依赖：将生成的sqlite3.dll放到以下位置之一：
  1. 与编译后的Rust可执行文件同目录
  2. 系统PATH环境变量包含的目录
• 编译命令直接执行即可：

  cargo build --example persons --features modern-full
  

核心注意事项 #

• 架构一致性：Rust编译目标（如x86_64-pc-windows-msvc）必须与SQLite编译的架构完全匹配，否则会出现链接错误
• 工具链环境：编译前必须确保Visual Studio C++ Build Tools的环境变量已正确加载（通过Visual Studio命令提示符启动或手动配置环境变量）
• 特性匹配：使用modern-full等特性时，要确保自定义SQLite编译时启用了对应的扩展（如FTS5、JSON1），避免运行时功能缺失

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