SQLite如何在指定列不存在时执行添加列操作

你之前执行的语句报错，核心原因有两个：

• SQLite的ALTER TABLE ... ADD COLUMN语法原生不支持直接拼接ON CONFLICT IGNORE子句，属于语法层面不兼容，因此会抛出near "ON": syntax error错误。
• ON CONFLICT子句的作用是定义列值冲突时的处理规则，本身没有“判断列是否存在”的逻辑，无法实现“列不存在才添加”的需求。

额外提醒：不要直接使用table作为表名，它是SQL保留关键字，如果必须使用需要用反引号包裹为`table`，否则也会触发语法错误。

根据你使用的SQLite版本，选择对应方案即可：

方案1：新版本SQLite（3.35.0及以上，2021年3月后发布）用原生语法 #

从3.35.0版本开始，SQLite为ADD COLUMN新增了IF NOT EXISTS判断支持，单条SQL即可实现需求，不需要额外逻辑：

-- 语法模板
ALTER TABLE 你的表名 ADD COLUMN IF NOT EXISTS 目标列名 列数据类型;

-- 实际示例：给user表添加类型为INTEGER的age列
ALTER TABLE user ADD COLUMN IF NOT EXISTS age INTEGER;

执行逻辑：如果目标列已经存在，语句会直接跳过、不抛出任何错误，完全匹配需求。

方案2：旧版本SQLite（3.35.0以下）先判断再添加 #

旧版本没有原生的IF NOT EXISTS支持，需要先查询系统内置的表元数据判断列是否存在，再决定是否执行加列操作，分两种使用场景：

场景A：在代码中通过宿主语言（Python/Java/Go/C#等）调用SQLite #

1. 第一步先查询目标表的所有列信息：

   PRAGMA table_info('你的表名');
   

   该查询返回的结果集里，name字段对应当前表的所有列名，遍历结果集检查目标列名是否存在即可。
2. 如果结果里没有找到目标列名，再执行普通的加列语句：

   ALTER TABLE 你的表名 ADD COLUMN 目标列名 列数据类型;
   

场景B：纯SQL脚本执行，无法借助宿主语言做逻辑判断 #

可以借助pragma_table_info表值函数做计数判断，仅当计数为0（列不存在）时执行加列，以sqlite3官方命令行客户端为例：

-- 动态拼接SQL，列不存在时生成加列语句，存在时生成空执行语句
SELECT CASE WHEN COUNT(*) = 0 THEN
    'ALTER TABLE 你的表名 ADD COLUMN 目标列名 INTEGER;'
ELSE
    'SELECT 1;'
END
FROM pragma_table_info('你的表名')
WHERE name = '目标列名';
.read

注意：不同SQLite GUI客户端对动态SQL的执行支持略有差异，如果客户端不支持动态SQL拼接执行，优先升级SQLite版本使用IF NOT EXISTS语法，或通过宿主语言逻辑判断实现。

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