Python sqlite3 怎样让查询结果按列名访问

Python 的 sqlite3 查询默认返回 tuple，所以 row[0] 能取值，但 row["name"] 会失败。最直接的做法是在创建游标前设置 Connection.row_factory = sqlite3.Row，之后就能按列名读取，同时保留下标访问。

官方地址：https://docs.python.org/3/library/sqlite3.html

如果一个连接下的大多数查询都希望按列名访问，优先使用 sqlite3.Row；只有确实需要普通字典或属性式对象时，再改用自定义工厂。

默认 tuple 为什么不能按列名取值

Python 内置的 sqlite3 模块默认返回的查询结果是按索引访问的元组，只要把连接对象的 row_factory 属性设置成 sqlite3.Row，后续所有查询返回的行对象就可以直接用列名作为键来访问对应字段值，不需要手动转换结果结构。

sqlite3 的默认行为遵循 DB-API 的常见形式：每一行是一个 tuple，位置和 SELECT 列表一一对应。列名保存在游标的描述信息里，但不会自动变成 tuple 的键。也就是说，下面的查询可以用下标读取，不能把列名当作下标。

import sqlite3

# 使用内存数据库演示查询结果的默认形态
con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE user_profile(id INTEGER, nickname TEXT)")
con.execute("INSERT INTO user_profile VALUES(?, ?)", (7, "小林"))

row = con.execute(
    "SELECT id, nickname FROM user_profile"
).fetchone()

print(row[0])       # 位置访问得到 id
print(row[1])       # 位置访问得到 nickname
# print(row["id"])  # 默认 tuple 不支持列名访问

con.close()         # 示例结束后显式释放连接

如果只是一次性的两三列读取，tuple 没有问题；但当 SQL 列表变化、查询列较多或业务代码需要表达字段含义时，位置下标会让维护成本变高。

首选方案：sqlite3.Row 支持列名和下标

把 sqlite3.Row 赋给连接的 row_factory，新创建的游标就会返回 Row 对象。它既支持 row[0]，也支持 row["id"]，还可以通过 keys() 查看当前查询真正返回的列名。列名访问不区分大小写，但建议在 SQL 中使用稳定、清晰的别名。

import sqlite3

con = sqlite3.connect(":memory:")
con.row_factory = sqlite3.Row  # 先设置工厂，再创建后续游标
con.execute("CREATE TABLE user_profile(id INTEGER, nickname TEXT)")
con.execute("INSERT INTO user_profile VALUES(?, ?)", (7, "小林"))

row = con.execute(
    "SELECT id AS user_id, nickname FROM user_profile"
).fetchone()

print(row.keys())          # 查看查询列名：['user_id', 'nickname']
print(row["user_id"])      # 按列名读取
print(row["NICKNAME"])     # sqlite3.Row 的列名访问不区分大小写
print(row[0])               # 仍然可以按位置读取

con.close()                 # 不再使用时关闭连接

要注意设置时机：连接的 row_factory 会作为新游标的初始配置，已经创建的游标不会因为后来修改连接属性而自动改变。因此，工程代码通常在 connect() 后立即设置它。

sqlite3.Row、dict_factory 和 namedtuple 怎么选

三种方式都能把列名带进 Python 对象，但接口侧重点不同。sqlite3.Row 是默认推荐项，开销小且同时支持索引与映射访问；dict_factory 适合需要把结果直接交给 JSON 序列化或字典处理链的场景；namedtuple 适合希望用属性访问、并且查询列名稳定的内部数据结构。

import sqlite3
from collections import namedtuple

# 需要普通字典时，从游标描述信息读取列名
def dict_factory(cursor, values):
    fields = [column[0] for column in cursor.description]
    return dict(zip(fields, values))

# 需要属性访问时，把每行映射为 namedtuple
def namedtuple_factory(cursor, values):
    fields = [column[0] for column in cursor.description]
    Row = namedtuple("Row", fields)
    return Row._make(values)

con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE user_profile(id INTEGER, nickname TEXT)")
con.execute("INSERT INTO user_profile VALUES(?, ?)", (7, "小林"))

con.row_factory = dict_factory
row = con.execute("SELECT id, nickname FROM user_profile").fetchone()
print(row["nickname"])       # 字典访问，方便传入字典处理逻辑

con.row_factory = namedtuple_factory
row = con.execute("SELECT id, nickname FROM user_profile").fetchone()
print(row.nickname)           # 属性访问，适合固定字段的内部对象

con.close()                   # 两种工厂共用同一个连接，示例末尾统一关闭

实际使用时的三个边界

• 优先给重复列起别名：联表查询中不要依赖两个同名列，使用 SELECT u.id AS user_id 这样的别名，结果对象才有稳定键。
• 不要把 Row 当成完全等价的 dict：需要 json.dumps() 或字典展开时，显式写成 dict(row)，并先确认字段名和空值语义。
• 设置后再创建游标：如果连接已经产生了游标，后改连接的 row_factory 不会回写到旧游标；也可以只给某个游标单独设置工厂，但这会降低统一性。

因此，一般项目可以把连接初始化固定为 sqlite3.Row，在需要输出字典或属性对象的边界处再做一次明确转换。这样既保留了列名语义，也不会让每个查询都重复编写“值和列名手工拼接”的代码。

常见问题

sqlite3.Row 能不能同时用下标和列名？

可以。它支持整数下标，也支持列名映射访问；列名访问按官方文档是不区分大小写的。

为什么设置了 row_factory 还是返回 tuple？

最常见原因是设置发生在游标创建之后，或者查询实际使用的是另一条连接。把设置放在连接创建后、所有游标创建前，通常就能避免这个问题。

什么时候应该直接用 dict_factory？

当结果马上进入字典合并、JSON 组装或模板上下文时可以选择它；如果只是希望查询代码更易读，sqlite3.Row 通常更稳妥。