TableLite 使用说明书整体界面一览

这份说明书按「你会在界面上看到什么、每个控件做什么」来组织。 每一章都用线框图画出界面,图上标着数字编号,下面的表格逐个解释这些控件的作用与快捷键。

这个工具是做什么的

TableLite 是一个在 macOS 上运行的 MySQL 客户端,用来日常查看数据、改数据、跑 SQL。 它是自用工具,不是通用产品,因此界面上没有多余的东西。

它擅长的事

  • 打开一张表,限制显示条数、排序、筛选着看
  • 选中一行后在右侧字段栏里改字段、增删行,改完先预览再一次性提交
  • 写 SQL 跑脚本,多个语句的结果分开看
  • 通过 SSH 跳板机连内网数据库
  • 把数据导成 CSV,也能从 CSV 导一批数据进来

它不做的事

  • 不改表结构(建表、加列、加索引请手写 DDL)
  • SQL 编辑器没有自动补全、没有格式化
  • 查询结果只读,只有表数据视图能改
  • 除 CSV 之外的导入导出格式(Excel、JSON、SQL dump)
  • 不支持 MySQL 之外的数据库
  • 数据网格没有撤销重做,回退靠「放弃全部改动」(SQL 编辑器里有撤销 / 重做)
先记住这一条

在界面上做的任何修改都不会立刻写进数据库。改动会先进入「变更暂存区」, 你确认无误后再点提交,所有改动打包在一个事务里执行——要么全部成功,要么全部回滚。 所以看到一个橙色的格子,说明这个改动还没生效,随时可以放弃。

主窗口长什么样

整个程序只有一个窗口,最上面是与系统标题栏合一的工具栏(红绿灯按钮与窗口标题就在这一行里,下沿有一条连接颜色带),往下是主体区。 主体区横向分三块:左侧栏(库、对象树)、标签内容区、右侧字段栏(表数据标签专有)。 下图的数字对应后面表格里的说明。

TableLite 主窗口整体布局 本地开发 ▾ app_dev / users 🔍 ↻ 🕘 >_ ▤ app_dev ▾ 🔍 搜索表、视图… ▾ 表 (128) users orders articles … ▾ 视图 (3) v_active_users users 查询 1 orders + # id name email content created_at 1 1 张三 zs@example.c… 这是一篇很长的文… 2025-01-01 2 2 李四 ls@example.c… «BLOB 12.3 KB» 2025-01-02 3 3 王五 NULL NULL 2025-01-03 300 / 约 12,480 行 ▾ + 插入行 ⓘ bio 23.5 KB 筛选 列 导出 数据网格(只读) 单元格不能编辑:双击只会跳到右侧字段栏对应的字段 🔍 搜索字段 18 字段 🔑 id int unsigned 1 ∅ name varchar(255) 张三 ∅ email varchar(255) zs@example.com ∅ content longtext 这是一篇很长的文… ∅ photo blob «图片 PNG 45.2 KB» ∅ created_at datetime 2025-01-01 10:00 ∅ 右侧字段栏 表数据标签专有 · 默认显示 改数据只在这里改,网格是只读的 …(滚动查看更多字段) 1 2 3 4 5 6 7 8 9 10
图 0-1 主窗口整体布局。数字编号对应下面的控件说明表。
#控件作用快捷键
1连接切换器 显示当前连接与所在库。点开可以切换到别的连接、编辑连接、重新连接或断开。切换连接不会断开之前那个连接,只是换一组标签来看。⌘K 切换库
2快速打开 弹出一个表名搜索框,不用去左侧栏翻。⌘P
3刷新 刷新对象树与当前标签的数据;与菜单「连接 → 刷新」一致。⌘R
4连接颜色带 一条 2pt 的细带,用连接配置里的颜色着色。给生产库配红色,一眼就能看出当前在哪个环境。—
5库切换器与搜索框 上面是当前连接的库下拉,点开可以换库。下面是对象树搜索框,输入即过滤,会自动展开所有分组。⌘F 聚焦搜索
6对象树 当前库里的表、视图,分组标题上带数量。单击表打开数据视图,右键有更多操作。⌘R 刷新
7查询历史 / Console Log 工具栏右侧的两个全局入口,只显示图标(时钟 / 终端),鼠标悬停时显示名称。查询历史记录你在编辑器里跑过的语句;Console Log 记录所有发给服务器的语句,包括客户端自动发的元数据查询。它们不属于对象树,也不随当前库或标签变化。⇧⌘C
8标签栏 当前连接打开的所有东西:表数据、表结构、查询、历史、日志。每个标签标题前有类型图标,当前标签用圆角底色块突出;标题右边的橙点表示这个标签有未提交的改动。中键点击关闭标签。⌘W ⌘[ ⌘] ⌘1…⌘9
9标签内容区(数据网格) 占窗口最大的部分。表数据标签里是只读的数据网格:能选、能排序、能复制,但不能在格子里改值。查询标签里是编辑器加只读结果区,结构标签里是只读的列表。—
10右侧字段栏 表数据标签专有:选中一行后,这里列出它的全部字段(列名、类型、值),也是唯一能改数据的地方。顶部有「搜索字段」框。默认显示,用工具栏最右的 ▤ 或「视图 → 显示/隐藏右侧字段栏」开关,没有快捷键。—

怎么读这份说明书

  1. 先看第 2 章「界面结构」,把窗口各分区的职责弄清楚,后面所有章节都在这套框架里。
  2. 图上带数字的圆点和下面的表格一一对应。鼠标移到表格某一行,图上的圆点会变成橙色,方便定位。
  3. 橙色的提示框是需要特别注意的行为,红色的提示框是不可撤销的操作。
  4. 末尾的第 12、13 章是速查表:快捷键总表和提示文案规范,可以当参考手册随时翻。

功能与章节对照

我想……去哪一章
新建一个连接,或者配 SSH 跳板机01 · 连接、10 · SSH 隧道
搞清楚窗口里每块区域是干什么的02 · 界面结构
打开一张表翻数据、排序、看大字段03 · 浏览表数据
改数据、加行、删行,然后提交(编辑在右侧字段栏里做)04 · 编辑数据
只看符合条件的行,或者隐藏某些列05 · 过滤器
写 SQL、跑多条语句、查历史记录06 · 查询编辑器
看一张表的列、索引、外键、建表语句07 · 表结构视图
导出数据给别人,或者从 CSV 导一批数据进来08 · 导入与导出
防止误改生产库09 · 只读模式
调整默认显示多少行、编辑器字体之类11 · 偏好设置
查某个操作的快捷键12 · 快捷键总表
弄明白某个弹窗或报错是什么意思13 · 提示与错误
完全离线

这份说明书就是一组静态 HTML 文件,放在项目的 manual/ 目录里。 直接双击 index.html 用浏览器打开即可,不需要起服务器,也没有任何外部依赖。 需要纸面版时用浏览器的「打印 → 存储为 PDF」。