Python/SQLite：表与字段名用变量还是字面量？客观选择依据？

两种实现方式示例 #

1. 变量定义表与字段名 #

先把表名、字段名用常量变量统一声明，再拼接到SQL语句中：

_SCHEDULE_TABLE = "schedule"
_SCHEDULE_COL_ZONE_ID = "zone_id"
_SCHEDULE_COL_ENABLED = "enabled"
_SCHEDULE_COL_LEVEL = "level"

# 创建表的SQL
create_table_sql = f"CREATE TABLE {_SCHEDULE_TABLE} ({_SCHEDULE_COL_ZONE_ID} int, {_SCHEDULE_COL_ENABLED} int, {_SCHEDULE_COL_LEVEL} text)"

# 查询SQL
count_query_sql = f"SELECT COUNT({_SCHEDULE_COL_ZONE_ID}) FROM {_SCHEDULE_TABLE} WHERE {_SCHEDULE_COL_ZONE_ID}='{zone_id}'"

2. 直接使用字面量 #

直接在SQL语句中写表名、字段名的字面量，仅动态参数用变量代入：

count_query_sql = f"SELECT COUNT(zone_id) FROM schedule WHERE zone_id='{zone_id}'"

客观选择依据与适用场景 #

适合用变量的场景 #

• 多环境适配或动态数据源：如果代码需要对接不同配置的SQLite实例（比如测试环境表名带test_前缀），用变量统一管理可以一次性修改所有相关SQL，避免重复劳动和遗漏。
• 动态SQL生成需求：业务逻辑需要动态切换查询的表或字段时，变量可以作为配置项灵活调整，不用硬修改SQL模板。
• 大型多人协作项目：统一用变量定义表/字段名能形成开发规范，避免不同开发者拼写不一致；万一后续真的需要修改表结构，只需要改动一处变量定义，无需全局搜索替换，降低出错风险。

适合用字面量的场景 #

• 小型单数据源项目：项目规模小、表结构长期稳定，直接写字面量的SQL可读性更强，不用跳转查看变量定义，代码更简洁。
• IDE支持完善的场景：PyCharm等IDE提供SQL语法检查、自动补全功能，足以避免表/字段名的拼写错误，变量的防错优势被弱化。
• 上线后无结构变更计划：数据库上线后修改表/字段名属于高危操作，一般不会轻易变更，变量的“统一修改”优势基本用不上，反而增加代码冗余。

性能损耗问题 #

两种方式在性能上没有明显差异。Python的f-string在运行时解析，不管用变量还是字面量，最终生成的SQL字符串完全一致，SQLite执行时处理的是相同的语句，不会带来额外开销。

⚠️ 注意：示例中的SQL拼接方式存在SQL注入风险，正确的做法是使用SQLite的参数化查询，比如：

count_query_sql = "SELECT COUNT(zone_id) FROM schedule WHERE zone_id=?"
cursor.execute(count_query_sql, (zone_id,))

无论用变量还是字面量，参数化查询都是必须的，既能避免注入问题，还能让SQLite更好地缓存执行计划。

内容的提问来源于stack exchange，提问作者martin's