本文介绍在 python 2 和 3 兼容环境下，使用三重引号（""" 或 '''）安全构建跨多行的 sql 查询字符串的方法，避免语法错误，并保持代码可读性与维护性。
在编写数据库交互逻辑时，SQL 查询往往结构复杂、嵌套深层、条件繁多，单行书写不仅违反 PEP 8 可读性原则，还极易因引号冲突、换行符缺失或括号不匹配引发 SyntaxError。尤其当查询需拼接进 shell 命令（如通过 subprocess 调用 CLI 工具）时，字符串内部已含单引号、反斜杠甚至换行，普通双引号或单引号字符串难以承载。
此时，Python 的三重引号字符串（triple-quoted strings） 是最简洁、健壮且跨版本兼容的解决方案。它天然支持跨行书写、保留内部空白与换行，并能自由混用单双引号，无需转义——完美适配嵌套子查询、长 WHERE 条件及命令行参数封装等典型场景。
✅ 正确写法：使用三重引号包裹多行 SQL
def build_sql_command():
return ("""usr/bin/query-tool -e 'SELECT val1
FROM table_name
WHERE val2 = (
SELECT val3
FROM another_table
WHERE val = "abc"
)'""")? 注意：示例中将内层单引号 'abc' 改为双引号 "abc"，是为了避免与外层 SQL 字符串的单引号冲突（虽三重引号允许嵌套单引号，但混合引号更清晰）。若必须用单引号，可直接保留：WHERE val = \'abc\' —— 但非必需，三重引号已消除转义压力。
⚠️ 关键注意事项
- 兼容性无忧：三重引号自 Python 2.0 起即被完全支持，无需任何版本判断或导入，适用于所有主流环境（包括遗留系统）。
-
换行即真实换行：字符串中出现的换行符 \n 会被原样保留。若目标工具（如 PostgreSQL psql -c 或自定义 CLI）要求 SQL 必须为单行，请显式替换：
sql = """SELECT a, b FROM t WHERE x IN (SELECT y FROM u)""" single_line = sql.replace('\n', ' ').replace(' ', ' ').strip() -
避免意外缩进：三重引号内容若缩进书写（如函数体内对齐），缩进空格会成为字符串一部分。推荐以下任一方式规避：
- 使用括号隐式续行（推荐用于简单拼接）：
return ("usr/bin/tool -e 'SELECT val1 FROM table_name " "WHERE val2 = (SELECT val3 FROM another_table " "WHERE val = \"abc\")'") - 或用 textwrap.dedent() 清理缩进：
import textwrap sql = textwrap.dedent("""\ SELECT val1 FROM table_name WHERE val2 = (SELECT val3 FROM another_table WHERE val = "abc") """).strip() return f"usr/bin/tool -e '{sql}'"
- 使用括号隐式续行（推荐用于简单拼接）：
? 总结
面对长 SQL 查询，拒绝强行压成一行或滥用 + 拼接。三重引号是 Python 提供的“开箱即用”利器：语义清晰、零学习成本、全版本兼容。配合合理缩进处理与必要时的换行清理，即可写出既健壮又易维护的数据库交互代码。记住口诀：多行 SQL → 三引号；引号冲突 → 换引号类型；缩进污染 → dedent() 或括号续行。
