SQLEditor 是一款专为 macOS 设计的可视化数据库建模工具。它允许用户通过直观的图形界面设计数据库结构，并自动生成对应的 SQL 创建脚本，或反向从现有 SQL 文件导入生成数据模型图。本指南将详细介绍其核心界面、完整工作流程及进阶技巧。
一、核心界面与工作区详解
启动 SQLEditor 后，主界面主要分为以下几个关键区域：
- 菜单栏与工具栏： 位于窗口顶部，提供文件操作、编辑、视图、生成 SQL 等核心命令的快捷访问。
- 导航面板（左侧）： 通常以侧边栏形式存在，包含两个主要选项卡：
- 表格列表： 以树状结构列出项目中的所有表格、字段、关系、索引和注释。
- 样式/模板： 用于管理图表的外观，如颜色、字体和线条样式。
- 主画布（中央区域）： 这是可视化设计数据库的核心区域。在此处，表格以矩形框呈现，框内显示字段名、数据类型、主键/外键图标。表格之间的关系通过连接线表示。
- 检查器面板（右侧）： 当选中画布中的某个对象（如表、字段、关系线）或导航面板中的项目时，此面板会显示并允许编辑该对象的详细属性，如名称、数据类型、默认值、约束条件等。
- 信息栏/状态栏（底部）： 显示当前项目的状态信息，如选中对象的类型、缩放比例等。
二、完整操作流程：从创建到导出
1. 创建新项目
步骤一： 启动软件后，从菜单栏选择 “文件” > “新建”，或直接使用快捷键 Command + N。
步骤二： 在弹出的对话框中，为项目命名并选择保存位置。SQLEditor 项目文件通常以 .sqleditor 或 .sqleditorx 为扩展名。
2. 设计数据表
步骤一：添加表格。 点击工具栏上的“添加表格”按钮（图标通常为一个带加号的表格），或从菜单栏选择 “编辑” > “添加” > “表格”，或使用快捷键 Command + T。一个新表格将出现在画布中央。
步骤二：编辑表格属性。 单击选中画布上的新表格，右侧检查器面板将显示“表格”属性。在“名称”字段中输入表格名，如 Users。
步骤三：添加字段。 在检查器面板中切换到“字段”选项卡。点击下方的“+”按钮添加新行。在每一行中，您可以设置：
- 名称： 字段名，如
user_id。 - 类型： 数据类型，如
INTEGER,VARCHAR(255),TEXT,DATETIME等。 - 主键/非空等约束： 通过勾选对应的复选框进行设置。
- 默认值/注释： 在相应列中填写。
您也可以在导航面板的表格列表下，右键点击目标表格，选择“添加字段”。
3. 建立表间关系
步骤一： 点击工具栏上的“添加关系”按钮（图标为一条线连接两个表格），或从菜单栏选择 “编辑” > “添加” > “关系”。
步骤二： 首先点击画布上的“父表”（如 Departments 表的 dept_id 主键字段），然后点击“子表”（如 Users 表的 department_id 字段）。一条带有“钥匙”和“无穷大”符号的连接线将自动生成，表示一对多关系。
步骤三： 选中关系线，在右侧检查器中可以编辑关系属性，如关系名称、更新/删除时的级联规则。
4. 生成 SQL 脚本
步骤一： 设计完成后，从菜单栏选择 “文件” > “导出” > “SQL 生成…”，或使用快捷键 Command + E。
步骤二： 在弹出的导出设置窗口中，进行关键配置：
- 目标数据库： 在下拉菜单中选择您要兼容的数据库系统（如 MySQL, PostgreSQL, SQLite 等）。这决定了生成的 SQL 语法。
- 生成选项： 选择需要生成的内容，如“创建表格”、“创建索引”、“删除表格（DROP）”等。
- 文件格式与编码： 选择输出文件的格式和字符编码。
步骤三： 点击“生成”按钮，选择保存路径和文件名，即可将完整的 SQL 建表脚本导出为 .sql 文件。
5. 从 SQL 文件反向导入（逆向工程）
步骤一： 从菜单栏选择 “文件” > “导入” > “从 SQL 文件…”。
步骤二： 选择包含 CREATE TABLE 等语句的 SQL 文件。
步骤三： SQLEditor 会解析 SQL 并尝试在画布上自动生成对应的表格和关系图。您可能需要手动调整布局。
三、常用功能进阶技巧
- 批量编辑字段： 在导航面板的表格列表中，可以展开表格，直接在其字段列表上进行多选（按住
Command键点击），然后在右侧检查器中批量修改某些通用属性（如数据类型前缀）。 - 使用模板快速美化： 在左侧导航面板切换到“样式”选项卡，可以应用内置的配色和字体模板，或创建自定义模板，一键改变整个图表的外观。
- 布局优化： 选中多个表格后，右键选择“排列”下的子菜单（如“水平对齐”、“垂直分布”），或使用工具栏的布局按钮，可以快速整理杂乱的图表布局。
- 添加注释与笔记： 除了字段级别的注释，还可以从 “编辑” > “添加” > “注释” 向画布添加自由文本注释框，用于说明整体设计逻辑。
- 快速查找与跳转： 使用快捷键
Command + F可以打开搜索框，快速定位到特定的表格或字段名。
四、常见问题与解决方案
Q1: 生成的 SQL 脚本在目标数据库上运行报错（如语法错误）。
解决方案： 检查导出设置中的“目标数据库”是否选择正确。不同数据库系统的数据类型和特性有差异。确保在检查器中为字段设置的数据类型与目标数据库兼容。
Q2: 从 SQL 文件导入后，表间关系没有自动生成。
解决方案： 逆向工程功能依赖于 SQL 中明确定义的外键约束（FOREIGN KEY ... REFERENCES）。如果原 SQL 文件未包含这些约束，则需要手动在 SQLEditor 中创建关系。确保导入的 SQL 是完整的建表语句。
Q3: 画布上的表格过多，布局混乱，难以管理。
解决方案：
- 使用“缩放”工具（快捷键
Command+ 鼠标滚轮）缩小视图，总览全局。 - 利用导航面板的表格列表，可以快速选中被遮挡的表格。
- 使用“自动排列”功能（在“排列”菜单中），或按功能模块分组选中表格后手动排列。
Q4: 如何比较两个版本的数据模型差异？
解决方案： SQLEditor 本身不直接内置模型比较工具。常见做法是：将两个版本分别导出为 SQL 脚本，然后使用专业的 SQL 文本比较工具（如内置的 `diff` 命令或图形化 Diff 工具）进行比对。
五、SQLEditor for Mac 快捷键汇总表
| 功能分类 | 操作描述 | 快捷键 (Mac) |
|---|---|---|
| 文件操作 | 新建项目 | Command + N |
| 打开项目 | Command + O | |
| 保存项目 | Command + S | |
| 导出 SQL (生成) | Command + E | |
| 编辑操作 | 撤销 | Command + Z |
| 重做 | Command + Shift + Z | |
| 剪切 | Command + X | |
| 复制 | Command + C | |
| 粘贴 | Command + V | |
| 对象操作 | 添加新表格 | Command + T |
| 添加新关系 | Command + R | |
| 添加注释/笔记 | Command + Shift + N | |
| 视图与导航 | 放大画布 | Command + (+) |
| 缩小画布 | Command + (-) | |
| 适应窗口大小 | Command + 0 | |
| 实际大小 (100%) | Command + 1 | |
| 查找/搜索 | Command + F | |
| 选择与布局 | 全选 | Command + A |
| 分组选中对象 | Command + G | |
| 取消分组 | Command + Shift + G |
通过以上指南，您可以系统地掌握 SQLEditor for Mac 的核心功能与操作流程。其核心价值在于将抽象的数据库结构可视化，并通过严谨的图形化操作生成准确的 SQL 代码，极大地提升了数据库设计阶段的效率与准确性。
