DB Browser for SQLite 常用操作与自动化边界详解

目标：用无头环境可验证的方式讲清 DB Browser for SQLite（DB4S）的核心工作流——数据库准备与 SQL 脚本执行、CSV 导入、数据浏览、PRAGMA 查看修改、加密库管理；并用同一环境实测厘清它的命令行自动化边界（-q 不执行脚本、--import-csv 弹交互对话框），最后给出一套可完整脚本化的 sqlite3 CLI 对照流程。本文所有命令与回显均在 Ubuntu 22.04 x86_64 上对 3.12.1（apt 版）与 3.13.1（官方 AppImage 版）两个版本实测通过。

一、环境信息

项目	值
操作系统	Ubuntu 22.04 LTS (jammy)，x86_64
DB4S 版本	3.12.1-2（apt，/usr/bin/sqlitebrowser）、3.13.1（官方 AppImage，部署路径 /opt/db4s/，见安装指南）
sqlite3 CLI	3.37.2（jammy 源）
sqlcipher CLI	3.15.2（jammy 源，用于加密库对照）
虚拟显示	Xvfb（X.Org X server 虚拟帧缓冲）
配置目录	~/.config/sqlitebrowser/
实验数据目录	/root/（init.sql、demo.db、cities.csv 等）

💡 说明：DB4S 是 Qt 桌面 GUI 应用，没有"服务端模式"。所谓"无头验证"，是指用 Qt 的 offscreen 平台插件或 Xvfb 虚拟显示让应用完成启动、执行脚本等真实动作，再用 sqlite3 CLI 检查数据库文件的变化，从而对 GUI 应用的行为取得可复核的证据。

二、前置条件

已按《Ubuntu 22.04 安装 DB Browser for SQLite 指南》完成 DB4S 安装（apt 或 AppImage 任一通道）；
sqlite3 与（加密场景）sqlcipher CLI：

apt-get install -y sqlite3 sqlcipher

无显示环境时的两种运行底座，选其一：
- apt/发行版包版 DB4S：Qt 带 offscreen 插件，直接加环境变量即可（见 3.1）；
- AppImage 版 DB4S：只内置 xcb 插件，需装 Xvfb 虚拟显示（见 3.2）。

三、无头环境的可验证运行方法

3.1 offscreen 平台插件（apt 版实测可用）

发行版包编译的 DB4S 带 offscreen 等 Qt 平台插件（不带显示启动时它会在报错里列出来）。直接运行 sqlitebrowser --version 会因连不上显示而失败：

qt.qpa.xcb: could not connect to display
qt.qpa.plugin: Could not load the Qt platform plugin "xcb" in "" even though it was found.
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, xcb.

加上 QT_QPA_PLATFORM=offscreen 即可正常取版本与执行脚本：

QT_QPA_PLATFORM=offscreen sqlitebrowser --version

实测回显（3.12.1）：

QStandardPaths: XDG_RUNTIME_DIR not set, defaulting to '/tmp/runtime-root'
DB Browser for SQLite Version 3.12.1

Built for x86_64-little_endian-lp64, running on x86_64
Qt Version 5.15.1
SQLite Version 3.33.0.

⚠️ 注意：QStandardPaths: XDG_RUNTIME_DIR not set 是 SSH 会话的正常提示，可用 export XDG_RUNTIME_DIR=/tmp/xdgr && mkdir -p $XDG_RUNTIME_DIR 消除。

3.2 Xvfb 虚拟显示（AppImage 实测必须）

官方 AppImage 只打包了 xcb 插件，offscreen 方式会报错：

qt.qpa.plugin: Could not find the Qt platform plugin "offscreen" in ""
This application failed to start because no Qt platform plugin could be initialized. Reinstalling the application may fix this problem.

Available platform plugins are: xcb.

解决办法是给 xcb 一个可连的 X 服务——Xvfb 虚拟帧缓冲：

apt-get install -y xvfb
Xvfb :99 -screen 0 1280x1024x24 > /dev/null 2>&1 &
export DISPLAY=:99
/opt/db4s/squashfs-root/usr/bin/sqlitebrowser --version

实测回显（3.13.1，界面语言为 zh_CN 时）：

DB Browser for SQLite 版本 3.13.1
构建时的最新提交: dce95c4

为 x86_64-little_endian-lp64 构建，运行于 x86_64
Qt 版本 5.12.8
SQLCipher 版本 4.6.1 community (基于 SQLite 3.46.1)。

3.3 后台驻留与终止模式（关键：不能带 -q）

不带 -q 启动时，DB4S 会打开数据库、执行 -s 指定的脚本，然后停留在 GUI 事件循环等待窗口关闭。无头环境无法点窗口，因此采用"后台启动 → 等待脚本执行完成 → 终止进程"的节奏（下文 4.2 实测验证脚本确实已执行）。这是无头环境使用 DB4S 的基本范式：

QT_QPA_PLATFORM=offscreen sqlitebrowser -s 脚本.sql 数据库.db &
等待数秒后 kill 该进程

四、核心工作流实操与验证

4.1 数据库准备与建表脚本（-s 参数）

GUI 场景：启动后点工具栏 "New Database" 新建库，切到 Database Structure 标签用 "Create Table" 向导建表。无头等价操作是把建表 SQL 写进脚本，用 -s 交给 DB4S 执行。

⚠️ 排障实录（实测）：目标数据库文件必须已经存在。直接对不存在的库启动会得到如下回显且什么都不会发生：
Invalid option/non-existant file: /root/demo.db
解决：先用 sqlite3 /root/demo.db "VACUUM;" 生成一个空库文件（或在 GUI 里新建保存一次），再交给 DB4S。

完整实测流程（3.12.1 apt 版，offscreen）：

# 1) 准备建表脚本 init.sql
cat /root/init.sql

实测文件内容：

CREATE TABLE IF NOT EXISTS staff(id INTEGER PRIMARY KEY, name TEXT, salary REAL);
INSERT INTO staff VALUES(1,'张三',12000.5),(2,'李四',9800);

# 2) 先创建空库文件
sqlite3 /root/demo.db "VACUUM;"
# 3) 后台启动 DB4S 执行脚本
QT_QPA_PLATFORM=offscreen sqlitebrowser -s /root/init.sql /root/demo.db > /tmp/d.log 2>&1 &
sleep 5 && kill %1
# 4) 用 sqlite3 检查结果
sqlite3 /root/demo.db ".tables"
sqlite3 -header -column /root/demo.db "SELECT * FROM staff;"

实测回显：

staff
id  name  salary
--  ----  -------
1   张三    12000.5
2   李四    9800.0

DB4S 进程日志（仅有常规提示，无错误）：

QStandardPaths: XDG_RUNTIME_DIR not set, defaulting to '/tmp/runtime-root'
This plugin does not support propagateSizeHints()
This plugin does not support propagateSizeHints()

结论：-s 在不带 -q 的启动流程中真实执行了建表与插数，效果可被 sqlite3 独立复核。

4.2 脚本执行的两条实测规则：失败回滚与只读拒绝

规则一：脚本某条语句出错，整个脚本的效果回滚。 把 init.sql 里的字符串引号去掉制造语法错误后重跑同样的流程，.tables 查不到任何表，DB4S 进程日志里出现明确的错误回显：

"Error in statement #1: no such table: staff.\nAborting execution."

（INSERT 里的裸词 张三 被 SQLite 解析为对不存在对象的引用，第 1 条出错后 CREATE TABLE 一并回滚。）

规则二：-R 只读模式下写库被拒。 用只读方式打开并执行 PRAGMA user_version = 777;：

QT_QPA_PLATFORM=offscreen sqlitebrowser -R -s /root/ro.sql /root/test.db > /tmp/ro.log 2>&1 &
sleep 5 && kill %1
sqlite3 /root/test.db "PRAGMA user_version;"
cat /tmp/ro.log

实测回显（版本值保持 100 未变，日志给出错误）：

100
"Error in statement #1: attempt to write a readonly database.\nAborting execution."

这两条错误回显也是排查 -s 脚本"静默无效"的抓手——无头运行时务必重定向 stderr 查看日志。

4.3 CSV 导入：GUI 向导与命令行参数的真实行为

GUI 场景（官方能力清单表述："Import and export tables from/to CSV files"，来源：sqlitebrowser.org 首页，查询日期 2026-10-23）：菜单 File → Import → Table from CSV file，在弹出的导入对话框中选择文件、确认表名/分隔符/编码/首行是否表头，点 OK 完成导入。

命令行参数 --import-csv（3.13 起新增，官方 Wiki CLI 页标注"Import this CSV file into the passed DB or into a new DB"）的实测行为与预期不同：

printf "id,city,pop\n1,Hangzhou,12370000\n2,Suzhou,12750000\n" > /root/cities.csv
sqlite3 /root/imported.db "SELECT 1;"        # 先造一个空库
/opt/db4s/squashfs-root/usr/bin/sqlitebrowser -q --import-csv /root/cities.csv /root/imported.db
sqlite3 /root/imported.db ".tables"

实测结果：.tables 输出为空——没有任何数据被导入。源码佐证（v3.13.1 src/MainWindow.cpp 的 importCSVfiles()）：

ImportCsvDialog dialog(inputFiles, &db, this, table);
if (dialog.exec())
    refreshTableBrowsers();

即 --import-csv 做的只是预先填好文件的交互式导入对话框（dialog.exec() 模态等待用户点击），并非无人值守的导入接口；配合 -q 时应用甚至不会走到这里（见 5.1）。无头批处理导入请用 sqlite3 CLI 的 .import（见 6.5）。

4.4 数据浏览与编辑（Browse Data 标签）

GUI 场景（来源：官方 Wiki《Browse-Data》页，查询日期 2026-10-23）：Browse Data 标签以表格形式浏览数据；点击列头按单列排序；按住 Ctrl/cmd 点击列头可叠加多列排序键，再 Ctrl/cmd 点击已排序列可将其移出排序序列。单元格双击进入编辑，工具栏 New Record / Delete Record 增删行。

命令行的等价入口是 -t/--table <表>——打开库后把浏览焦点定位到指定表（源码：switchToBrowseDataTab(...)），3.13 起还允许与 --import-csv 搭配作为导入目标表。它是"GUI 焦点"性质的参数，不产生数据库写入。

4.5 PRAGMA 的查看与修改（Edit Pragmas 标签）

GUI 场景：Edit Pragmas 标签以表单列出当前数据库的 PRAGMA（user_version、application_id、page_size、journal_mode 等），改动后由应用写回数据库文件头。

无头等价验证：用 -s 脚本执行 PRAGMA 写入，再用 sqlite3 复核。实测（3.13.1 AppImage，Xvfb 环境）：

printf "PRAGMA user_version = 100;\n" > /root/v100.sql
/opt/db4s/squashfs-root/usr/bin/sqlitebrowser -s /root/v100.sql /root/test.db &
sleep 6 && kill %1
sqlite3 /root/test.db "PRAGMA user_version;"

实测回显：

运行中（kill 之前）用另一个 sqlite3 会话查询同样能看到 100——PRAGMA 写入即时持久化，GUI 的 Edit Pragmas 标签改 user_version 与此等价。

4.6 加密数据库（SQLCipher）

GUI 场景（来源：官方 Wiki《Encrypted-Databases》页，查询日期 2026-10-23）：

只能对已存在的数据库加密——想得到新的加密库，先建一个普通库再加密；
入口是菜单 Tools → Set Encryption，输入密码即可对库加密；对已加密库，打开时会弹出密码对话框（CipherDialog）。

加密参数由构建内置的 SQLCipher 版本决定，DB4S 的加密对话框提供两套预设（源码 CipherDialog.cpp）：

预设	page_size	kdf_iter	HMAC	PBKDF2
SQLCipher 3	1024	64000	SHA1	SHA1
SQLCipher 4	4096	256000	SHA512	SHA512

与其他客户端的互操作性实测（Ubuntu sqlcipher CLI 3.15.2 按 SQLCipher 3 默认参数建库）：

sqlcipher /root/enc.db "PRAGMA key = \"q1w2e3r4\"; CREATE TABLE secret(id INTEGER, val TEXT); INSERT INTO secret VALUES(1,'top-secret');"
sqlite3 /root/enc.db ".tables"
sqlcipher /root/enc.db "PRAGMA key = \"q1w2e3r4\"; SELECT * FROM secret;"

实测回显：

Error: file is not a database
1|top-secret

标准 sqlite3 CLI 打不开 SQLCipher 加密库（报 file is not a database），sqlcipher CLI 带正确密钥可正常读写；DB4S 打开该库时在 CipherDialog 中选择 SQLCipher 3 预设并输入密码即可（预设参数与 sqlcipher 3.x 默认值一致）。加密与解密入口在 GUI，命令行参数中没有对应开关——这是 DB4S 与 CLI 工具在加密场景的分工。

五、自动化边界（实测结论）

5.1 `-q` 与 `-s` 组合不会执行脚本（两版本一致）

官方 Wiki CLI 页对 -q 的描述是"Exit application after running scripts"，并给出示例 sqlitebrowser -s Aquariums_preload.sql -q Aquariums.db。但实测在 3.12.1 与 3.13.1 上，-q -s 脚本库 组合执行后，用 sqlite3 检查目标库均无任何变化（以 PRAGMA user_version = 100; 为探针，版本值保持 42 不变）。

源码佐证（v3.12.1 src/Application.cpp，v3.13.1 同构）：-q 置位"不显示主窗口"标志后，构造函数在此提前返回——

if(m_dontShowMainWindow) {   // 3.13.1 为 if(!m_showMainWindow)
    m_mainWindow = nullptr;
    return;
}

而打开数据库与执行脚本的代码位于该提前返回之后，永远不会被执行。这是官方文档与实际行为的偏差：需要执行脚本时，绝不能带 -q；脚本执行完后进程会驻留（GUI 事件循环），由启动方按 3.3 节的后台模式终止。

5.2 `--import-csv` 是交互对话框，不是批量导入接口

见 4.3 实测与源码引用：该参数只负责"预填文件的导入对话框"，导入与否取决于用户在对话框上的点击。无头环境实测无任何数据落库。

5.3 `-t`/`-R` 的语义边界

-t <表>：仅定位 GUI 浏览焦点，无写入语义；
-R：真实生效的只读开关，写库会得到 attempt to write a readonly database 错误并中止脚本（4.2 实测）——对"防止自动化脚本误写"反而是个有用特性。

5.4 边界结论矩阵

需求	DB4S 命令行	结论
取版本/帮助	`--version` / `--help`	可用（offscreen 或 Xvfb 底座）
启动时写/读配置	`-O` / `-o` / `-S`	可用（细节见《DB Browser for SQLite 配置参数详解》）
打开库执行 SQL 脚本	`-s`（不带 -q，后台+kill）	可用但受限：库文件须先存在、出错整体回滚、错误看 stderr
无人值守 CSV 导入	`--import-csv`	不可用（弹交互对话框）
执行完自动退出	`-q`	不可用（提前返回，脚本不执行）
加密/解密	无命令行入口	仅 GUI（Tools → Set Encryption）
CI/定时任务批处理	—	应改用 sqlite3 CLI（第六章）

六、sqlite3 CLI 对照详解

DB4S 命令行是"带状态的启动入口"，sqlite3 CLI 才是完整的脚本化工具。以下全部命令在 Ubuntu 22.04（sqlite3 3.37.2）实测。

6.1 版本确认

sqlite3 --version

实测回显：

3.37.2 2022-01-06 13:25:41 872ba256cbf61d9290b571c0e6d82a20c224ca3ad82971edc46b29818d5dalt1

6.2 建库建表与元数据

sqlite3 /root/company.db <<"SQL"
CREATE TABLE dept(id INTEGER PRIMARY KEY, name TEXT NOT NULL);
CREATE TABLE emp(id INTEGER PRIMARY KEY, name TEXT, salary REAL CHECK(salary>0), dept_id INTEGER REFERENCES dept(id));
CREATE INDEX idx_emp_dept ON emp(dept_id);
INSERT INTO dept VALUES(1,'研发部'),(2,'市场部');
INSERT INTO emp VALUES(1,'张三',12000.5,1),(2,'李四',9800,1),(3,'王五',7600,2);
SQL
sqlite3 /root/company.db ".tables"
sqlite3 /root/company.db ".schema emp"

实测回显：

dept  emp
CREATE TABLE emp(id INTEGER PRIMARY KEY, name TEXT, salary REAL CHECK(salary>0), dept_id INTEGER REFERENCES dept(id));
CREATE INDEX idx_emp_dept ON emp(dept_id);

6.3 格式化查询

sqlite3 -header -column /root/company.db \
  "SELECT e.name, e.salary, d.name AS dept FROM emp e JOIN dept d ON e.dept_id=d.id WHERE e.salary>8000 ORDER BY e.salary DESC;"

实测回显：

name  salary   dept
----  -------  ------
张三    12000.5  研发部
李四    9800.0   研发部

6.4 PRAGMA 体检三件套

sqlite3 /root/company.db "PRAGMA table_info(emp);"
sqlite3 /root/company.db "PRAGMA index_list(emp);"
sqlite3 /root/company.db "PRAGMA foreign_key_list(emp);"
sqlite3 /root/company.db "PRAGMA integrity_check;"

实测回显：

0|id|INTEGER|0||1
1|name|TEXT|0||0
2|salary|REAL|0||0
3|dept_id|INTEGER|0||0
0|idx_emp_dept|0|c|0
0|0|dept|dept_id|id|NO ACTION|NO ACTION|NONE
ok

6.5 CSV 导入导出（批处理主战场）

导出：

sqlite3 -header -csv /root/company.db "SELECT * FROM emp;" > /root/emps.csv
cat /root/emps.csv

实测回显：

id,name,salary,dept_id
1,"张三",12000.5,1
2,"李四",9800.0,1
3,"王五",7600.0,2

导入到不存在的表：首行自动成为列名（不会把表头当数据）：

rm -f /root/new.db
sqlite3 /root/new.db ".mode csv" ".import /root/cities.csv cities"
sqlite3 /root/new.db "SELECT rowid,* FROM cities;"

实测回显：

1|1|Hangzhou|12370000
2|2|Suzhou|12750000

导入到已存在的表：所有行（含首行）都会作为数据插入——这是最常见的踩坑点，实测：

rm -f /root/new.db
sqlite3 /root/new.db "CREATE TABLE cities(id INTEGER, city TEXT, pop INTEGER);"
sqlite3 /root/new.db ".mode csv" ".import /root/cities.csv cities"
sqlite3 -header -column /root/new.db "SELECT * FROM cities;"

实测回显（第一行数据就是表头文本）：

id  city      pop
--  --------  --------
id  city      pop
1   Hangzhou  12370000
2   Suzhou    12750000

⚠️ 注意：.import 的 --skip 1（跳过首行）选项是 SQLite 3.41.0 才加入的（来源：sqlite.org changes.html 中 3.41.0 条目 "Add options to the .import command: --csv, --ascii, --skip"，查询日期 2026-10-23）；Ubuntu 22.04 自带的 3.37.2 没有该选项。老版本的惯用绕法：先删掉 CSV 首行再导入，或导入临时表后用 SQL 剔除首行。

6.6 脚本执行 `.read`

printf "UPDATE emp SET salary=salary*1.05 WHERE dept_id=1;\nSELECT id,name,salary FROM emp;\n" > /root/raise.sql
sqlite3 -header -column /root/company.db ".read /root/raise.sql"

实测回显：

id  name  salary
--  ----  ---------
1   张三    12600.525
2   李四    10290.0
3   王五    7600.0

与 DB4S -s 的关键差别：.read 是前台同步执行，命令结束即完成，退出码可判，天然适合 shell/CI。

6.7 备份与 SQL 转储

sqlite3 /root/company.db ".backup /root/company_backup.db"
sqlite3 /root/company_backup.db ".tables"
sqlite3 /root/company.db ".dump" | head -6

实测回显：

dept  emp
PRAGMA foreign_keys=OFF;
BEGIN TRANSACTION;
CREATE TABLE dept(id INTEGER PRIMARY KEY, name TEXT NOT NULL);
INSERT INTO dept VALUES(1,'研发部');
INSERT INTO dept VALUES(2,'市场部');

6.8 事务与变更确认

sqlite3 /root/company.db "BEGIN; INSERT INTO emp(id,name,salary,dept_id) VALUES(4,'赵六',11000,2); SELECT changes(); ROLLBACK; SELECT count(*) FROM emp;"

实测回显（回滚后仍是 3 行）：

1
3

6.9 加密库边界

见 4.6：标准 sqlite3 CLI 无法打开 SQLCipher 加密库（实测 Error: file is not a database），需改用 sqlcipher CLI（PRAGMA key + 语句）或 DB4S 图形界面。加密库的批量运维脚本应基于 sqlcipher 包的 CLI。

七、注意事项

版本行为差异：-q、--import-csv、-S 的行为以本文实测口径为准，且在 3.12.1 与 3.13.1 间并不完全一致（-S、--import-csv 为 3.13 新增）；升级 DB4S 后涉及自动化的部分应重新验证。
错误诊断看 stderr：无头执行 -s 时把输出重定向到文件（> /tmp/x.log 2>&1），Error in statement #N: ... 是定位脚本问题的唯一线索。
脚本原子性：DB4S 的 executeMultiSQL 出错即中止并回滚整个脚本；如需"部分成功"的批处理语义，请在 sqlite3 CLI 中自行控制事务。
同库交替操作：DB4S、sqlite3、应用三方操作同一 .db 文件完全互通，但注意 WAL/锁——DB4S 长时间打开库会持有连接，脚本写入前最好先关闭 GUI 会话。
加密组件与版本有关：apt 通道 3.12.1 不带 SQLCipher（--version 无该行），加密库场景务必用官方 AppImage/Flatpak/Snap 通道（内置 SQLCipher 4.6.1）。
示例密码：本文 q1w2e3r4 仅为演示口令，生产环境请使用高强度密钥并妥善保管——SQLCipher 库丢失密钥即永久无法解密。

八、常见问题（FAQ）

8.1 `-s` 执行完，数据库里什么都没变

按顺序排查：(1) 是否带了 -q——带了就不会执行（5.1）；(2) 目标库文件是否存在——不存在会回显 Invalid option/non-existant file（4.1）；(3) 看 stderr 是否有 Error in statement #N——脚本出错会整体回滚（4.2）。

8.2 无显示服务器上怎么做 DB4S 的自动化

apt 版用 QT_QPA_PLATFORM=offscreen；AppImage 版用 Xvfb。启动放后台，等待后 kill（3.3）。但更推荐的答案是：自动化本身交给 sqlite3 CLI，DB4S 只做"人"的操作（5.4 矩阵）。

8.3 CSV 导入后第一行变成了数据

那是 .import 到已存在表的行为（6.5 实测）。让首行做列名要么导入到不存在的表（自动建表），要么用 3.41+ 的 --skip 1，要么导入前剥离首行。

8.4 打开加密库报 "file is not a database"

库是 SQLCipher 加密的，标准 sqlite3 CLI 打不开。用 DB4S GUI（CipherDialog 输密码）或 sqlcipher CLI（PRAGMA key）。

8.5 `--version` 都要图形环境，正常吗

正常。Qt 应用在解析命令行参数前先初始化平台插件，无显示环境用 offscreen 插件或 Xvfb 解决（3.1/3.2 实测回显）。

九、参考链接

官方 Wiki 命令行文档：https://github.com/sqlitebrowser/sqlitebrowser/wiki/Command-Line-Interface
官方 Wiki 加密数据库文档：https://github.com/sqlitebrowser/sqlitebrowser/wiki/Encrypted-Databases
官方 Wiki 数据浏览文档：https://github.com/sqlitebrowser/sqlitebrowser/wiki/Browse-Data
v3.12.1 参数处理源码：https://github.com/sqlitebrowser/sqlitebrowser/blob/v3.12.1/src/Application.cpp
v3.13.1 参数处理源码：https://github.com/sqlitebrowser/sqlitebrowser/blob/v3.13.1/src/Application.cpp
sqlite3 CLI 官方文档：https://sqlite.org/cli.html
SQLCipher 官网：https://www.zetetic.net/sqlcipher/
本专栏姊妹篇：《DB Browser for SQLite 介绍与选型指南》、《Ubuntu 22.04 安装 DB Browser for SQLite 指南》、《DB Browser for SQLite 配置参数详解》

DB Browser for SQLite 常用操作与自动化边界详解

DB Browser for SQLite 常用操作与自动化边界详解

一、环境信息

二、前置条件

三、无头环境的可验证运行方法

3.1 offscreen 平台插件（apt 版实测可用）

3.2 Xvfb 虚拟显示（AppImage 实测必须）

3.3 后台驻留与终止模式（关键：不能带 -q）

四、核心工作流实操与验证

4.1 数据库准备与建表脚本（-s 参数）

4.2 脚本执行的两条实测规则：失败回滚与只读拒绝

4.3 CSV 导入：GUI 向导与命令行参数的真实行为

4.4 数据浏览与编辑（Browse Data 标签）

4.5 PRAGMA 的查看与修改（Edit Pragmas 标签）

4.6 加密数据库（SQLCipher）

五、自动化边界（实测结论）

5.1 -q 与 -s 组合不会执行脚本（两版本一致）

5.2 --import-csv 是交互对话框，不是批量导入接口

5.3 -t/-R 的语义边界

5.4 边界结论矩阵

六、sqlite3 CLI 对照详解

6.1 版本确认

6.2 建库建表与元数据

6.3 格式化查询

6.4 PRAGMA 体检三件套

6.5 CSV 导入导出（批处理主战场）

6.6 脚本执行 .read

6.7 备份与 SQL 转储

6.8 事务与变更确认

6.9 加密库边界

七、注意事项

八、常见问题（FAQ）

8.1 -s 执行完，数据库里什么都没变

8.2 无显示服务器上怎么做 DB4S 的自动化

8.3 CSV 导入后第一行变成了数据

8.4 打开加密库报 "file is not a database"

8.5 --version 都要图形环境，正常吗

九、参考链接

5.1 `-q` 与 `-s` 组合不会执行脚本（两版本一致）

5.2 `--import-csv` 是交互对话框，不是批量导入接口

5.3 `-t`/`-R` 的语义边界

6.6 脚本执行 `.read`

8.1 `-s` 执行完，数据库里什么都没变

8.5 `--version` 都要图形环境，正常吗