SQLite 3.46版本在函数库方面做了一次比较实用的补充，重点解决了开发者在处理Unicode文本、可读JSON输出以及日期时间格式化时的一些不便。新增的函数数量不算特别多，但每一个都针对明确的使用场景，而且与现有SQL语法高度兼容。对于已经在项目中使用SQLite的团队来说，升级到3.46后可以直接在SQL查询层完成更多原本需要应用程序后处理的工作，减少代码往返和格式转换开销。下面分别介绍这几个新增函数的具体行为。
unistr函数：让Unicode转义序列回到字符本身
unistr函数的作用是把字符串中的Unicode转义序列转换为对应的UTF-8字符。很多编程语言都有类似的字符串处理能力，例如JavaScript中的JSON.parse或者Python中的unicode_escape解码，但在SQL内部一直没有特别直接的手段。假设数据库中存了一段包含转义序列的文本，比如从某个日志系统导出的数据，里面写的是Hello\u0020World，希望得到实际空格字符，在SQLite 3.46之前往往需要借助应用层代码处理。现在可以直接使用unistr函数完成转换。
unistr支持两种转义形式：一种是四位十六进制的\uXXXX，另一种是八位十六进制的\UXXXXXXXX。这里的反斜杠是普通字符，在SQL字符串中必须按照SQLite的字符串字面量规则书写。比如要传入\u4F60\u597D，在标准SQL字符串中反斜杠不是转义字符，因此可以直接写成'\\u4F60\\u597D'或者使用单引号内的原始反斜杠，具体取决于当前连接是否开启了反斜杠转义。为了代码可读性，通常建议写成两个反斜杠以避免歧义。unistr函数会扫描整个输入字符串，并把所有符合条件的转义序列替换为对应的Unicode字符，其他普通字符原样保留。
示例：
SELECT unistr('Hello\\u0020World') AS result;
-- 返回：Hello World
SELECT unistr('\\u4F60\\u597D') AS greeting;
-- 返回：你好
SELECT unistr('\\U0001F600') AS emoji;
-- 返回：😀
这个函数在数据清洗时非常有用，特别是从一些API返回的JSON字符串中可能包含转义后的Unicode内容，如果直接存储在SQLite中并对用户展示，就会出现原始转义序列而不是可读字符。unistr配合JSON函数使用可以一步完成解析和可读化转换，减少后端代码的复杂度。
json_pretty函数：让紧凑JSON变得易于阅读
SQLite的JSON扩展已经提供了不少函数，例如json_extract、json_array、json_object等，这些函数生成的JSON文本通常是紧凑格式，没有额外的空格或换行。对于存储和传输来说紧凑格式有优势，但当开发者需要查看数据内容或者生成对外展示的报表时，紧凑JSON可读性较差。json_pretty函数就是用来解决这个问题的，它接受一个JSON文本参数，返回经过格式化的版本，增加缩进和换行，使嵌套结构清晰可见。
json_pretty函数属于JSON扩展的一部分，因此使用前需要确保SQLite编译时启用了JSON1扩展。在大多数现代SQLite发行版中该扩展默认包含，无需额外配置。如果输入的JSON文本不合法，函数会抛出错误，这一点与json函数的行为类似。格式化后的JSON使用两个空格作为缩进层级，键名和字符串值保持原有引号风格，数字和布尔值不会改变类型。
示例：
SELECT json_pretty('{"name":"sqlite","version":3.46,"active":true}') AS pretty_json;
执行结果会以一种多行缩进的形式展示出来。json_pretty还可以和json_object、json_array等函数组合使用，先动态构造JSON再美化输出。例如：
SELECT json_pretty(json_object('id', 1, 'tags', json_array('db', 'sql', 'embedded'))) AS formatted;
这种组合方式在需要生成配置文件片段或者调试SQL返回的JSON结构时特别高效，不必把结果复制到外部工具中格式化。与unistr类似，json_pretty也是标量函数，可以放在SELECT列表、WHERE条件或者ORDER BY表达式中，不过通常用在SELECT列表中做展示。
日期时间函数的新格式支持
SQLite的日期时间函数家族包括date、time、datetime、julianday和strftime等，它们共享同一套格式化代码。3.46版本对strftime函数做了小幅度扩展，新增了几个更贴近常用习惯的格式化指令，其中%F等价于%Y-%m-%d，%T等价于%H:%M:%S，%R等价于%H:%M。这些简写形式在不少编程语言和数据库系统中已经是惯例，SQLite补上之后可以让SQL代码更简洁，也方便从其他系统迁移过来的开发者快速上手。
使用这些新格式并不影响原有代码，旧的%Y-%m-%d等写法仍然有效。如果需要提取完整日期时间，可以用strftime('%F %T', 'now')，返回类似2024-05-23 14:30:00的结果。对于只需要小时和分钟的场景，%R会省略秒，减少多余信息。这些格式化指令同样适用于date和time函数内部的格式参数，不过date和time函数本身默认输出已经固定，通常还是配合strftime使用更灵活。
示例：
SELECT strftime('%F %T', 'now') AS datetime_now;
-- 返回：2024-05-23 14:30:00（示例值）
SELECT strftime('%R', 'now') AS hour_minute;
-- 返回：14:30（示例值）
虽然这些新格式看起来只是语法糖，但对于每天需要写大量SQL的开发者来说，减少重复的格式化字符串可以降低拼写错误，也让查询意图更直接。需要注意的是，如果你的部署环境SQLite版本尚未升级到3.46，使用这些格式代码会导致返回空字符串或错误，因此在跨版本兼容时需要留意。
实际应用中的组合使用与注意事项
三个新增特性在实际项目中经常可以组合起来。比如一个报表接口需要从数据库中取出JSON格式的配置信息，同时以可读形式展示给运维人员，并且配置文本中还含有Unicode转义序列。此时可以在一行SQL中完成从原始存储到最终展示的全部转换：先用json_extract提取字段，再用unistr还原转义字符，最后用json_pretty美化输出。SQLite的函数嵌套能力让这类数据流水线变得非常自然，不需要多次查询和中间临时表。
使用unistr时要特别留意SQL字符串中转义反斜杠的问题。SQLite默认情况下反斜杠不是转义字符，因此字符串'\\u0020'实际上包含一个反斜杠和字母u0020共六个字符，这正好是unistr期望的输入格式。但如果连接层或ORM对SQL做了一次额外的字符串转义，就可能导致反斜杠数量变化，使unistr无法正确识别。建议在单元测试中固定输入输出样例，避免因为编码层级复杂而出现不可见字符。
json_pretty函数返回的字符串本身就包含换行符，因此在命令行客户端中查看结果时会被正确显示，但如果通过程序接口取回字符串再拼接进HTML页面，可能需要额外处理换行符。另外json_pretty不改变JSON的键值顺序，也不会对键名做排序，它只是负责美化空格和缩进。如果希望JSON键按字母顺序排列，需要配合其他函数或应用层实现。日期时间新格式则相对独立，主要影响strftime的书写习惯，没有额外副作用。
SQLite 3.46unistr函数json_pretty函数修改时间：2026-08-23 14:53:16