为何Python的sqlite3模块不遵循位置参数的顺序？

近期遇到一个特殊行为：使用SQLite的$1、$2数字参数标识指定插入顺序，但实际查询结果和插入数据顺序不符，参数数字标识好像被忽略了。以下是代码示例及运行结果：

import sqlite3, platform

insert = (10, "today")
db = sqlite3.connect(":memory:")
db.execute("CREATE TABLE t (number, string)")
db.execute("INSERT INTO t (string, number) VALUES ($2, $1)", insert)
select = db.execute("SELECT number, string FROM t").fetchone()

print(f"python version: {platform.python_version()}")
print(f"sqlite version: {sqlite3.sqlite_version}, module: {sqlite3.version}")
print(f"insert: {insert}")
print(f"select: {select}")

运行结果：

python version: 3.10.5
sqlite version: 3.38.5, module: 2.6.0
insert: (10, 'today')
select: ('today', 10)

我预期查询结果与插入数据一致，但实际不符，推测参数的数字标识被忽略，请问为何Python会忽略该顺序？

Python的sqlite3模块默认不支持SQLite的数字参数占位符（$N）按位置映射，它会把所有占位符（不管是?、:name还是$N）都按传入参数的顺序依次绑定，完全忽略数字标识。

具体到你的代码：

• 当执行INSERT INTO t (string, number) VALUES ($2, $1)并传入元组(10, "today")时，sqlite3不会识别$2对应第二个参数、$1对应第一个参数，而是直接将元组的第一个元素10传给第一个占位符（$2的位置），第二个元素"today"传给第二个占位符（$1的位置）。
• 最终表中string列被插入10，number列被插入"today"，查询时自然得到('today', 10)的结果。

如果要实现按数字标识指定参数顺序，需要使用字典形式传入参数，sqlite3默认支持命名占位符映射：

import sqlite3, platform

# 用字典映射$1、$2到对应参数
insert = {"$1": 10, "$2": "today"}
db = sqlite3.connect(":memory:")
db.execute("CREATE TABLE t (number, string)")
db.execute("INSERT INTO t (string, number) VALUES ($2, $1)", insert)
select = db.execute("SELECT number, string FROM t").fetchone()

print(f"python version: {platform.python_version()}")
print(f"sqlite version: {sqlite3.sqlite_version}, module: {sqlite3.version}")
print(f"insert: {insert}")
print(f"select: {select}")

运行这段代码就能得到预期的(10, 'today')结果。

另外更常用的方式是：

• 使用?占位符时严格按参数顺序传参；
• 使用命名占位符（如:num、:str）来明确参数对应关系，避免依赖数字标识的歧义。

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