GoLand中装sqlite3驱动需配系统C工具链和SQLite头文件，不能仅靠IDE；macOS用brew install sqlite3，Ubuntu装libsqlite3-dev，Windows需GCC和DLL；路径应避免硬编码，推荐内存模式或动态拼接。
GoLand里直接装sqlite3驱动就行，别碰CGO环境变量
GoLand 本身不干预数据库驱动编译，但 github.com/mattn/go-sqlite3 是 CGO 驱动，依赖系统级 sqlite3 库。很多人卡在 go build 报错：exec: "gcc": executable file not found in $PATH 或 #include <sqlite3.h> 找不到——这不是 GoLand 的问题，是本地没装 C 工具链或 sqlite3 头文件。
实操建议：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- macOS：运行
brew install sqlite3，再确认pkg-config --modversion sqlite3能输出版本 - Ubuntu/Debian：装
sudo apt install libsqlite3-dev，不是只装sqlite3命令行工具 - Windows：用
choco install sqlite3或从 sqlite.org 下预编译 DLL + 头文件，手动设CGO_CFLAGS和CGO_LDFLAGS - 不想配 CGO？换纯 Go 驱动
modernc.org/sqlite，无 C 依赖，但不支持 WAL、FTS5 等高级特性
go.mod 里加依赖后，GoLand 不识别 import 怎么办
常见现象：写了 import _ "github.com/mattn/go-sqlite3"，GoLand 标红，go run main.go 却能跑通。这是因为 IDE 没触发模块同步，或缓存未更新。
实操建议：
- 先在终端进项目根目录，执行
go mod tidy，确保go.mod里有该行且go.sum已写入哈希 - 回到 GoLand，点右上角
Load project图标（或File → Reload project） - 如果还标红，检查 Settings → Go → Go Modules → Environment 是否填了
GOPROXY=https://goproxy.cn,direct；没填就手动加上 - 避免在
main.go里直接写驱动导入却不调用——GoLand 有时会误判为“未使用”，加个空的sql.Open("sqlite3", "test.db")就能解除标红
SQLite 文件路径写相对还是绝对？开发时别硬编码
SQLite 是单文件数据库，路径错误会导致静默创建空库、或连接失败却无明确报错。比如 sql.Open("sqlite3", "./data/app.db") 在 GoLand 里运行时工作目录是项目根，但用 go run 启动时可能在 main.go 所在目录——结果连到两个不同文件。
实操建议：
- 用
os.Executable()定位二进制位置，再拼接数据库路径：dir, _ := filepath.Dir(os.Executable()); dbPath := filepath.Join(dir, "app.db") - 开发阶段优先用内存模式：
sql.Open("sqlite3", ":memory:")，避免文件权限、路径歧义问题 - 若必须用文件，通过命令行参数传入：
go run main.go -db ./dev.db，用flag.String("db", "app.db", "sqlite db path")接收 - 别在代码里写
C:\Users\...\app.db这种 Windows 绝对路径——跨平台直接失效
调试时看不到 SQLite 查询日志？别依赖 GoLand 控制台
GoLand 的 Debug Console 默认只显示 fmt.Println 类输出，而 github.com/mattn/go-sqlite3 的底层日志（如 prepare、exec）需显式开启，且不会打到 IDE 控制台。
实操建议：
- 启用驱动日志：在
sql.Open后加参数_ "github.com/mattn/go-sqlite3?_trace=true"，再设置环境变量SQLITE_LOG=1 - 更可靠的方式是封装
sql.DB，用log.Printf打印每条Exec/Query的 SQL 和耗时 - 不要指望 GoLand 的 “Database Tools” 插件连 SQLite 文件——它只支持 JDBC 数据源，对本地 .db 文件无感知
- 想查数据内容？直接用系统 sqlite3 命令：
sqlite3 app.db ".tables"或用 VS Code 装 SQLite Explorer 插件看，比在 GoLand 里折腾快得多
go build 时的环境变量（如 CGO_ENABLED=0）也不会自动同步给 IDE 的调试器。这两层要各自验证，不能只看一个地方成功就认为全通了。 
