第 02 章界面结构
整个程序只有一个窗口。窗口最上面是与系统标题栏合一的工具栏(红绿灯按钮与窗口标题就在这一行里), 往下依次是连接颜色带、主体区;主体区横向再分三块:左侧栏、标签内容区、右侧字段栏。 把这一章看明白,后面每一章都只是往这张图里填内容。
窗口分区与职责
| # | 区域 | 职责 | 会变的东西 |
|---|---|---|---|
| 1 | 工具栏 | 连接切换、快速打开、刷新、查询历史、Console Log;最右端是右侧字段栏开关 ▤。 | ▤ 只在表数据标签下可用。 |
| 2 | 连接颜色带 | 用连接配置里的颜色区分生产 / 测试 / 开发,专门用来防「以为自己连的是测试库」。 | 跟随连接配置里的颜色。 |
| 3 | 左侧栏 | 选择库、浏览对象。空分组直接隐藏。 | 随当前连接和当前库变化;可拖宽、可整体隐藏(⌃⌘S)。 |
| 4 | 标签栏 | 当前连接打开的所有标签。每个标签标题前有类型图标;当前标签用圆角底色块突出;有未提交改动的标签,标题右边有个橙色小圆点。 | 完全随打开的内容变化。 |
| 5 | 标签内容区 | 所有实际内容都在这里。表数据标签里是只读的数据网格;查询标签里是编辑器加只读的结果网格。 | 完全随标签类型变化。 |
| 6 | 右侧字段栏 | 只在表数据标签里出现:纵向列出焦点行的全部字段(列名 + 类型 + 值),是唯一能改数据的地方。 | 有选中行时自动出现,未选中时收起;可拖宽(260–560pt,默认 300pt)、可整体关闭。 |
选中一行后,窗口右侧会多出一列字段栏:纵向列出这一行的所有列,每行是列名(主键列带 🔑 并加粗)、
类型(灰色小字,如 varchar(255))、可直接编辑的值,以及右侧的 ∅(设为 NULL)按钮。
顶部有「搜索字段」框和字段计数。表数据标签里只有它能改数据——网格本身是只读的。
它默认启用,但只在有选中行(或新增行)时出现:没有选中行时收起,把宽度还给网格;查询结果、表结构、对象定义标签都没有。 用工具栏最右端的 ▤ 按钮,或菜单「视图 → 显示 / 隐藏右侧字段栏」来开关它; 宽度可以拖(260–560pt,默认 300pt)。这里故意不配快捷键: ⌘ 组合已经分给了网格、编辑器和标签操作,再挤一个进去只会互相抢按键。
工具栏
| # | 控件 | 作用 | 快捷键 |
|---|---|---|---|
| 1 | 连接切换器 | 点开是连接列表(见下图)。左边的小圆点是这个连接的状态:灰=未连接,转圈=连接中,绿=正常,红=异常。右边紧挨着的是「库 / 当前标签」标题。 | — |
| 2 | 快速打开 | 在当前库里搜索表 / 视图并打开。替代原来标题栏中间的大搜索框。 | ⌘P |
| 3 | 刷新 | 刷新对象树与当前标签的数据;与菜单「连接 → 刷新」一致。 | ⌘R |
| 4 | 查询历史 | 打开查询历史标签;记录从 SQL 编辑器执行过的语句。它是全局入口,不随当前库或标签变化。 | — |
| 5 | Console Log | 打开 Console Log 标签;记录所有发给服务器的语句,包括客户端自动发的元数据查询。与菜单「视图 → 显示 / 隐藏 Console Log」是同一个开关。 | ⇧⌘C |
| 6 | 右侧字段栏开关 ▤ | 整体开启 / 关闭右侧字段栏。只在表数据标签里可用,其它标签上是灰的。没有选中行时字段栏本来就会收起;它没有快捷键。 | — |
| 7 | 连接颜色带 | 一条 2pt 的细带,用连接配置里选的颜色。它是整窗口最容易扫到的一条线,专门用来防「以为自己连的是测试库」。 | — |
变更操作不再常驻工具栏。只有表数据标签有未提交改动时,网格下方才出现一条上下文变更条: N 处未提交 · 预览 SQL · 放弃 · 提交。没有改动时整条不出现。
工具栏最右端的 ▤ 开关只在表数据标签里可用——右侧字段栏本来就只服务它。
连接切换器
点工具栏最左边那个下拉,会展开当前保存的所有连接。
| # | 控件 | 作用 |
|---|---|---|
| 1 | 连接切换器按钮 | 显示当前连接名 + 状态点。无论你在哪个标签里,它永远在同一个位置。 |
| 2 | 连接项 | 点一下切过去。左侧是状态点,名称后面灰字是当前选中的库。切换后标签栏立刻变成那个连接的标签集合。 |
| 3 | 勾选标记 | 标出当前正在看的连接。展开时它会被高亮。 |
| 4 | 连接操作 | 新建连接… ⌘N;编辑当前连接…(改完保存会重连);重新连接 ⇧⌘R;断开连接 ⇧⌘D。 |
左侧栏
左侧栏从上到下是三层:选库、搜对象、看对象。 宽度可以拖,拖动后会记住;整个左侧栏也能用 ⌃⌘S 隐藏。
| # | 控件 | 作用 |
|---|---|---|
| 1 | 库切换器 | 列出当前连接能访问的所有库。库多的时候下拉里自带搜索框。选中后对象树刷新为该库的内容,SQL 编辑器里执行的语句也默认落在该库上;切换失败(库被删 / 没权限)时保持原来的库并提示。没选库时对象树显示「请选择一个数据库」。 |
| 2 | 对象搜索框 | 输入即过滤,大小写不敏感,按子串匹配。搜索时自动展开所有分组,只显示命中的对象。⌘F 可以直接聚焦到这里。 |
| 3 | 分组标题 | 表 / 视图两组,标题上带数量。可以折叠,折叠状态会记住。分组内容只在展开时才去加载,加载期间显示占位行。 |
| 4 | 对象项 | 单击表打开数据视图(已打开则切过去);单击视图在新标签打开只读定义。右键展开菜单,菜单里有「在新标签打开」。 |
| 5 | 右键菜单 | 见下表。注意最后两项是红色的,因为它们直接生效、不进暂存区。 |
| 6 | 500 项提示条 | 一个库超过 500 个表时只显示前 500 个,并在顶部挂这条提示,避免一次拉几千个名字把界面拖死。 |
表项的右键菜单
| 菜单项 | 行为 | 是否可撤销 |
|---|---|---|
| 打开数据 | 在当前标签打开数据视图 | — |
| 在新标签打开 | 强制新开一个标签打开数据视图 | — |
| 打开结构 | 在新标签打开表结构视图 | — |
| 复制表名 | 把表名放进剪贴板 | — |
| 导出… | 打开导出面板,源是整张表 | — |
| 导入 CSV… | 打开 CSV 导入向导,目标表就是它 | — |
| 截断表… | 清空表内所有数据 | 不能。需手动输入表名确认 |
| 删除表… | 删除整张表 | 不能。需手动输入表名确认 |
截断表 / 删除表的确认弹窗
这两件事没法通过「放弃改动」回退,所以确认方式比普通弹窗重一档: 先把要执行的 SQL 摆出来,然后要求你手动输入表名,输入正确才能点确认按钮。
标签栏
标签栏里的每个标签都属于当前连接。切换连接时,整条标签栏会换成那个连接的标签集合。 一共有六种标签。
| 标签类型 | 标题长这样 | 内容 | 可编辑 |
|---|---|---|---|
| 表数据 | users | 只读的数据网格 + 右侧字段栏 | 网格只读;在右侧字段栏里编辑(有主键且非只读连接) |
| 表结构 | users · 结构 | 列 / 索引 / 外键 / 触发器 / 建表语句 | 否(也没有字段栏) |
| 对象定义 | v_active_users | 视图的定义语句 | 否(也没有字段栏) |
| 查询 | 查询 1、查询 2… | SQL 编辑器 + 只读的结果网格 | 编辑器里可写;结果网格只读(也没有字段栏) |
| 查询历史 | 查询历史 | 历史记录列表 | 否 |
| Console Log | Console Log | 语句日志 | 否 |
右侧字段栏只在表数据标签里出现:查询结果、表结构、对象定义标签都没有。
标签的规则
- 打开一个已经打开过的同类标签,会直接切过去,不会新开一个。判断标准是「同一个连接 + 同一个对象」。
- 表结构总是单独占一个标签(对象树右键
打开结构)。同一个表可以同时开着数据和结构两个标签。 - ⌘W 关当前标签。有未提交改动时先问你。
- 有未提交改动的标签,标题右边有个橙色小圆点。
- 查询标签可以右键重命名。
- 中键点击标签 = 关闭它。
- 标签太多时横向滚动,不会挤成两行。
- ⌘1 到 ⌘9 跳到第 N 个标签。
关闭标签时会发生什么
| 标签状态 | 行为 |
|---|---|
| 有未提交改动 | 弹窗三选一:提交 / 放弃并关闭 / 取消 |
| 查询标签、内容来自草稿 | 直接关闭,不提示(内容已经自动存成草稿) |
| 查询标签、关联过磁盘文件且有新改动 | 提示保存 |
| 其它 | 直接关闭 |
连接信息与进度显示
窗口底部没有状态栏。连接信息收进工具栏最左的连接切换器:标签上只有状态点、锁图标(只读时)和连接名, 鼠标悬停时才展开完整信息。
状态点的含义
| 格式 | 含义 |
|---|---|
● 本地开发 · app_dev · MySQL 8.0.36 · utf8mb4 | 正常连接 |
末尾多一段 · 只读 | 该连接处于只读模式,用醒目颜色显示 |
| 圆点变黄 | SSH 隧道正在重建 |
| 圆点变红 | 连接已断开,内容区会盖一层遮罩 |
点这个切换器弹出的菜单(换连接 / 重连 / 断开 / 编辑连接)见前面的「连接切换器」一节。
进度显示在哪
长耗时操作都在发起它的地方显示进度,没有全局进度条:
| 操作 | 进度显示在 | 详见 |
|---|---|---|
| 执行查询 | 编辑器自己的状态栏与结果区:正在执行… 已接收 12,480 行(2.1 MB)(3.4 秒) | 第 6 章 |
| 提交修改 | 网格上盖的一层遮罩:正在提交 3/7…,旁边有「取消」 | 第 4 章 |
| 导出 | 导出面板:正在导出… 已写入 129,480 行(24.1 MB) | 第 8 章 |
| 进入只读连接 | 顶部轻提示:该连接处于只读模式,所有写操作已被禁用。 | 第 9 章 |
| 不可编辑的原因 | 网格底部条上方的一条提示,例如 该表没有主键,行顺序不保证,且不可编辑 | 第 3 章、第 4 章 |
| 表结构概况 | 表结构标签底部:11 列 · 3 索引 · 1 外键 · 0 触发器 | 第 7 章 |
| 有未提交的改动 | 标签标题的橙点 + 网格下方变更条上的待提交条数 | 第 4 章 |
菜单栏
| 菜单 | 内容 |
|---|---|
| TableLite | 关于 TableLite / 偏好设置… ⌘, / 退出 ⌘Q |
| 文件 | 新建连接 ⌘N、新建查询 ⌘T、关闭标签 ⌘W、导入 CSV… ⇧⌘I、导出… ⇧⌘E、打开脚本… ⌘O、脚本另存为… ⇧⌘S |
| 编辑 | 撤销 / 重做 / 剪切 / 复制 / 粘贴、注释切换 ⌘/、缩进 / 反缩进、查找 ⌘F |
| 连接 | 重新连接 ⇧⌘R、断开连接 ⇧⌘D、切换数据库 ⌘K、刷新 ⌘R、提交修改 ⌘S、预览 SQL ⇧⌘P、放弃修改 ⇧⌘⌫、取消查询 ⌘.、☑ 只读模式 |
| 视图 | 显示 / 隐藏左侧栏 ⌃⌘S、显示 / 隐藏右侧字段栏(没有快捷键)、显示 / 隐藏 Console Log ⇧⌘C、上一个 / 下一个标签 ⌘[ ⌘] |
| 窗口 | 最小化 / 缩放。没有「新建窗口」——单窗口应用 |
| 帮助 | 使用说明 / 打开数据目录 |
空状态
每种「没东西可显示」的情况都有专门的文案,不会只留一片空白。
右侧字段栏也有自己的空状态:数据标签里没有选中行时,它显示「选中一行以查看和编辑它的字段」; 选中多行时显示「已选中 12 行 · 请只选一行」,不列出字段。