TablePlus 是一款面向现代开发者的原生 macOS 数据库管理工具，以其高性能、优雅直观的界面和对多种数据库（如 MySQL、PostgreSQL、SQLite、Redis 等）的原生支持而著称。它摒弃了传统数据库客户端的复杂与笨重，提供了安全、稳定且高效的数据库操作体验。
一、核心界面与工作区详解
启动 TablePlus 后，用户将面对一个高度集成且逻辑清晰的工作环境。
1.1 主窗口构成
- 左侧连接导航栏： 显示所有已建立的数据库连接，按类型分组。可以在此创建新连接、组织连接组。
- 中部内容工作区： 核心操作区域，以标签页形式展示。每个标签页可以是：
- 查询编辑器： 编写和执行 SQL 语句。
- 结构视图： 展示表、视图、存储过程等对象的结构（字段、索引、外键等）。
- 内容视图： 以表格形式展示和编辑数据，支持直接单元格编辑。
- 信息视图： 显示当前选中对象（如表）的详细信息，如行数、大小、注释等。
- 右侧信息/工具面板： 根据当前焦点动态显示相关信息和工具。例如，在查询编辑器时，显示执行计划；在结构视图时，显示字段属性编辑面板。
- 底部状态栏与结果区： 显示查询执行状态、耗时、返回行数。SQL 查询的结果集直接显示在主工作区下方。
二、完整操作流程：从连接到导出
步骤1：创建新连接
方法： 点击左上角 + 按钮，或使用快捷键 Cmd + N。
位置： 弹出的模态窗口。
操作：
- 从支持的数据库列表中选择类型（如 MySQL）。
- 填写连接参数：名称、主机、端口、用户名、密码、数据库名。
- （可选）点击“Test Connection”测试连通性。
- 点击“Connect”保存并连接。
步骤2：浏览数据库对象与数据
方法： 在左侧导航栏点击展开连接，再展开数据库。
操作：
- 双击一个表名，将在新标签页中打开其内容视图，直接浏览和编辑数据。
- 右键点击表名，选择“Structure”，打开结构视图以管理字段和索引。
- 在内容视图，点击右上角的“Filter”图标可对数据进行筛选排序。
步骤3：执行 SQL 查询
方法1： 右键点击连接或数据库，选择“New Query”。
方法2： 使用快捷键 Cmd + T 在当前连接下新建查询标签页。
操作：
- 在打开的查询编辑器中编写 SQL 语句。
- 执行全部SQL： 点击工具栏的“Run Current”按钮（三角形图标），或按 Cmd + R。
- 执行选中部分SQL： 先选中部分SQL文本，再按 Cmd + R。
- 结果和消息将显示在编辑器下方。
步骤4：编辑与保存数据
方法： 在表的内容视图中直接点击单元格进行修改。
操作：
- 修改后，该行行首会显示铅笔图标，表示有未提交的更改。
- 要提交更改到数据库，点击视图底部的“Commit”按钮或按 Cmd + S。
- 要撤销所有未提交的更改，点击“Rollback”按钮。
- 注意： 直接数据编辑默认处于事务中，只有提交后才会永久生效。
步骤5：导出查询结果或数据
方法： 在查询结果视图或表内容视图，点击右上角的“Export”按钮。
位置： 工具栏右侧。
操作：
- 点击“Export”，选择导出格式（CSV, JSON, SQL Insert, Excel等）。
- 在弹出的对话框中配置导出选项（如分隔符、编码）。
- 选择保存路径，点击“Export”完成。
- 快捷操作： 选中结果集中的部分行，右键选择“Export Selected Rows…”可仅导出选中数据。
三、常用功能进阶技巧
3.1 多查询并行执行与结果比对
打开多个查询标签页（Cmd + T），可以同时编写和运行不同的脚本。利用分屏功能（窗口菜单中）将两个查询标签页并排，方便对比数据和结果。
3.2 智能自动完成与代码片段
在查询编辑器中，输入部分SQL关键字或表名/字段名前缀，按 Ctrl + Space 触发智能补全。你可以在 Preferences -> Editor -> Code Snippets 中创建自定义代码片段，通过输入缩写快速展开常用SQL模板。
3.3 安全连接与SSH隧道
在创建连接时，切换到“SSH”标签页，填写SSH隧道信息。TablePlus 会先通过SSH连接到跳板机，再连接到目标数据库，极大增强了连接安全性。所有连接密码均使用系统钥匙链加密存储。
3.4 自定义主题与编辑器字体
通过 Preferences -> Appearance 可以切换深色/浅色主题，或自定义编辑器字体、字号、行高，打造舒适的编码环境。
四、常见问题与解决方案
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 连接失败，提示“Cannot connect to server” | 1. 网络不通或主机/端口错误。 2. 用户名密码错误。 3. 数据库服务器未运行或防火墙限制。 |
1. 使用命令行工具（如 `telnet` 或 `nc`）测试端口连通性。 2. 仔细核对凭证，注意大小写。 3. 检查数据库服务状态，确认防火墙规则允许客户端IP连接。 |
| 执行查询非常慢 | 1. 查询未优化或数据量过大。 2. 网络延迟高。 3. 客户端机器资源不足。 |
1. 使用 Cmd + E 查看查询执行计划，优化SQL语句和索引。 2. 对于远程数据库，考虑使用SSH隧道或检查网络质量。 3. 在 TablePlus 的查询编辑器中，避免一次性查询超大量数据，使用 LIMIT 子句。 |
| 中文字符显示为乱码 | 数据库编码与客户端连接编码不匹配。 | 在创建或编辑连接时，于“高级”设置中，明确设置连接字符集（如 `utf8mb4`）。对于已存在的连接，可以在查询开始时执行 `SET NAMES ‘utf8mb4’;`。 |
| 无法直接编辑表数据（单元格不可点） | 1. 表缺少主键或唯一约束。 2. 当前用户权限不足。 3. 处于“只读”模式。 |
1. TablePlus 需要主键或唯一约束来唯一标识一行以进行更新。为表添加主键。 2. 确认数据库用户拥有对表的 UPDATE 权限。 3. 检查连接或标签页是否被设置为“只读”。 |
| 快捷键失效 | 与 macOS 系统或其他应用快捷键冲突。 | 前往 Preferences -> Shortcuts 查看并修改冲突的快捷键绑定。 |
五、TablePlus for Mac 快捷键汇总
| 功能分类 | 操作描述 | 快捷键 (Mac) |
|---|---|---|
| 通用操作 | 新建连接 | Cmd + N |
| 打开新查询标签页 | Cmd + T | |
| 关闭当前标签页 | Cmd + W | |
| 偏好设置 | Cmd + , | |
| 查询编辑器 | 执行当前查询（全部或选中） | Cmd + R |
| 格式化 SQL 代码 | Ctrl + K | |
| 显示/隐藏查询执行计划 | Cmd + E | |
| 触发代码自动完成 | Ctrl + Space | |
| 数据操作 | 提交数据更改（保存） | Cmd + S |
| 在内容视图中新增一行 | Cmd + I | |
| 刷新当前视图数据 | Cmd + R | |
| 导航与查找 | 在连接/数据库中快速跳转 | Cmd + P |
| 在编辑器或数据中查找 | Cmd + F | |
| 查找并替换 | Cmd + Option + F | |
| 界面控制 | 切换侧边栏（连接导航栏）显示/隐藏 | Cmd + Option + S |
通过掌握以上核心界面、操作流程、进阶技巧和快捷操作，您可以充分利用 TablePlus 的强大功能，高效、优雅地管理您的各类数据库。其设计哲学在于减少干扰，让开发者更专注于数据和查询本身。
