SQLite3 使用需注意路径、commit、占位符和主键设置:用绝对路径防 silent fail;增删改后必须 commit(),查询后需 fetchall() 等获取结果;参数化查询只支持 ? 占位符;INTEGER PRIMARY KEY 自增但复用 ID,加 AUTOINCREMENT 可避免跳号。

sqlite3 是 Python 自带的模块,不用装、不用配,连上就能用。只要你会写 SQL,5 分钟就能搭好一个本地数据库。
连接数据库时文件路径写错导致 silent fail
调用 sqlite3.connect("data.db") 时,如果路径含中文、空格或相对路径不明确(比如脚本在子目录里运行),可能创建出多个同名但位置不同的 .db 文件,查不到数据还以为“没写进去”。
- 用绝对路径更稳妥:
sqlite3.connect(r"C:\myapp\data.db")或sqlite3.connect("/home/user/myapp/data.db") - 检查当前工作目录:
import os; print(os.getcwd()),确认.db文件生成在哪 - 首次运行后立刻用文件管理器找找,别只信“代码没报错”
INSERT 和 SELECT 时忘记 commit() 或 fetchall()
cursor.execute("INSERT ...") 只是把语句发给数据库,不调 conn.commit() 就不会真正写入;cursor.execute("SELECT ...") 后不调 cursor.fetchall() 或 cursor.fetchone(),结果就“悬在空中”,打印出来是 <sqlite3.cursor object at></sqlite3.cursor>。
- 增删改操作后必须
conn.commit(),否则重启程序数据全丢 - 查询后要用
fetchall()(取全部)、fetchone()(取一行)或fetchmany(n)(取 n 行)拿到实际数据 - 别把
commit()和close()顺序搞反:先commit(),再close()
占位符用错引发 SQL 注入或类型错误
SQLite 的参数化查询只认 ? 占位符,不是 %s,也不是 {}。写成 "INSERT INTO user VALUES('%s', %d)" % (name, age) 不仅危险,还容易因单引号嵌套崩掉。
立即学习“Python免费学习笔记(深入)”;
- 正确写法:
cursor.execute("INSERT INTO user(name, age) VALUES(?, ?)", ("Alice", 28)) - 传单个值也要加逗号:
cursor.execute("SELECT * FROM user WHERE name = ?", ("Alice",))(注意("Alice",)是元组,不是字符串) - 批量插入用
executemany():cursor.executemany("INSERT INTO user VALUES(?, ?)", [("Bob", 30), ("Carol", 25)])
建表时 INTEGER PRIMARY KEY 没设 AUTOINCREMENT 的后果
写 id INTEGER PRIMARY KEY 能自增,但 SQLite 默认只在该列**为空时**自动填下一个整数;如果手动插了 id=100,下次自增就从 101 开始——这没问题。但如果你希望严格按插入顺序递增且不跳号,得显式加 AUTOINCREMENT:
- 安全写法:
id INTEGER PRIMARY KEY AUTOINCREMENT - 不加
AUTOINCREMENT时,SQLite 会复用被DELETE后释放的 ID,可能导致 ID 不连续 -
AUTOINCREMENT有轻微性能开销,小项目可忽略;但别省略PRIMARY KEY,否则无法触发自增逻辑
sqlite3 真正的坑不在语法,而在“太顺了”——它不报错、不提醒、不锁文件,你改了表结构却忘了删旧 .db 文件,或者漏了 commit() 还以为数据存好了。动手前先确认路径、写完立刻查一遍,比什么都管用。


















