Windows下使用SQLX时依赖重复编译卡顿问题求助

问题分析 #

从编译日志来看，核心问题是libsqlite3-sys被反复重建，进而触发上层sqlx-sqlite等依赖的重新编译。结合你提到的依赖文件日期异常（显示为2006年），大概率是Cargo的增量编译检测机制误判文件变化，或是本地缓存损坏导致的。

解决方案 #

1. 彻底清理缓存与编译产物 #

先清理项目编译产物和Cargo本地缓存，强制重新生成所有依赖的编译信息：

• 清理当前项目的编译产物：

  cargo clean
  

• 清理Cargo registry中已下载的SQLX相关依赖包（避免损坏缓存影响后续编译）：
  删除%USERPROFILE%\.cargo\registry\src\index.crates.io-6f17d22bba15001f路径下的libsqlite3-sys-*、sqlx-*、sqlx-sqlite-*等相关目录。

2. 修复异常文件的时间戳 #

你提到sqlx-sqlite的源文件日期显示为2006年，这会导致Cargo每次编译都误判文件被修改，手动修正时间戳：

• 打开文件资源管理器，导航到%USERPROFILE%\.cargo\registry\src\index.crates.io-6f17d22bba15001f\sqlx-sqlite-0.8.2\src目录
• 选中所有.rs文件，右键选择「属性」，在「详细信息」标签页修改「创建时间」和「修改时间」为当前日期或合理的最近日期

3. 调整SQLX的Feature配置 #

确保Cargo.toml中SQLX的feature配置无冲突，优先使用静态编译的bundled SQLite，避免系统依赖的动态检测：

[dependencies]
sqlx = { version = "0.8.2", features = ["sqlite", "bundled", "runtime-tokio-native-tls"] }

注意：避免同时启用bundled和系统sqlite相关feature（如vcpkg、pkg-config），这类组合可能触发依赖的动态重建。

4. 切换到稳定版Rust工具链 #

你当前使用的是nightly工具链，部分nightly版本的增量编译可能存在兼容性问题，切换到稳定版尝试：

rustup default stable

之后重新执行cargo build，观察是否还会反复编译依赖。

5. 检查Cargo增量编译配置 #

确保Cargo的增量编译功能正常启用（默认开启，但可能被配置覆盖）：

• 检查项目根目录的.cargo/config.toml或全局%USERPROFILE%\.cargo\config.toml，确保没有设置：

  [build]
  incremental = false
  

如果有上述配置，将其删除或改为incremental = true。

6. 调整Rust Analyzer的触发时机 #

在VSCode中调整Rust Analyzer的检查触发逻辑，避免每次输入字符都触发全量检查：

• 打开VSCode设置（Ctrl+,），搜索rust-analyzer.checkOnSave，确保仅在保存时触发检查
• 搜索rust-analyzer.cargo.buildScripts.enable，如果不需要动态build脚本的实时检查，可以暂时关闭

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