RazorSQL 是一款功能强大的跨平台数据库查询、编辑和管理工具，支持超过80种数据库类型。其 Mac 版本提供了直观的图形界面和丰富的专业功能，适用于数据库开发人员、数据分析师和系统管理员。
一、核心界面与工作区详解
1.1 主界面布局
启动 RazorSQL 后，主界面主要分为以下区域：
- 顶部菜单栏与工具栏：提供文件、编辑、查看、工具等主要功能入口。
- 左侧连接导航面板：显示已建立的数据库连接，可展开查看表、视图、存储过程等对象。
- 中央编辑与显示区：默认显示“起始页”，执行查询后变为 SQL 编辑器与结果标签页。
- 底部状态栏与信息面板：显示当前连接状态、执行时间、行数等关键信息。
1.2 关键工作区
- SQL 编辑器：支持语法高亮、自动补全、代码格式化。可通过
View -> Show Line Numbers显示行号。 - 数据浏览/编辑网格：以表格形式显示查询结果，可直接在网格内编辑数据并提交到数据库。
- 数据库对象管理器：在连接导航面板右键点击任何对象（如表），可选择“浏览”、“编辑”、“生成SQL”等操作。
- 可视化查询构建器：通过拖拽方式构建 SQL 查询，位于
Tools -> Visual Query Builder。
二、完整操作流程：从连接到导出
2.1 创建/连接数据库
- 点击工具栏 “连接” 图标或菜单栏
Connections -> Connect。 - 在弹出的连接管理器中，点击 “新建连接”。
- 选择数据库类型（如 MySQL、PostgreSQL、SQLite），填写连接参数（主机、端口、用户名、密码等）。
- 点击 “测试连接” 确认配置正确，然后点击 “保存并连接”。
提示：成功连接后，该连接会保存并在左侧导航面板列出，下次可直接双击连接。
2.2 编写与执行 SQL 查询
- 在左侧导航面板选中一个数据库连接或具体数据库。
- 点击工具栏 “新建 SQL 编辑器” 图标或按快捷键
Command + N（Mac）。 - 在打开的编辑器标签页中输入 SQL 语句，例如：
SELECT * FROM employees; - 点击工具栏 “执行” 图标（绿色三角形），或按快捷键
Command + Enter（执行当前语句）或Command + Shift + Enter（执行全部语句）。 - 查询结果将显示在编辑器下方的数据网格中。
2.3 浏览与编辑表数据
- 在左侧导航面板展开连接和数据库，找到目标表。
- 右键点击表名，选择 “浏览表” 或 “编辑表”。
- 在打开的数据网格中，可直接修改单元格内容。
- 修改后，点击网格上方的 “提交编辑” 按钮（对勾图标）将更改保存到数据库，或点击 “回滚编辑”（叉图标）取消。
2.4 导出查询结果
- 执行查询后，确保焦点在结果数据网格上。
- 点击菜单栏
Data -> Export Data，或右键点击网格选择 “导出数据”。 - 选择导出格式（如 CSV、Excel、JSON、HTML、XML 等）。
- 设置导出选项（如分隔符、编码、是否包含列标题），指定输出文件路径。
- 点击 “导出” 完成操作。
三、常用功能进阶技巧
3.1 高效查询编写
- 代码自动补全：在编辑器中输入部分关键字或对象名后，按
Control + Space触发补全建议。 - 快速注释/取消注释：选中多行，使用
Command + /进行行注释切换。 - SQL 格式化：选中杂乱的 SQL 代码，点击工具栏 “格式化 SQL” 图标或按
Command + Shift + F，使代码结构清晰。
3.2 多数据库与模式管理
- 同时管理多个连接：可以为不同项目或环境建立多个连接，并通过导航面板顶部的下拉列表快速切换。
- 模式比较与同步：使用
Tools -> Compare Database Schemas功能，比较两个数据库或模式的结构差异，并可生成同步脚本。 - SQL 历史与收藏：所有执行过的 SQL 语句会自动保存在
Tools -> SQL History中。可将常用语句添加到Tools -> Favorites以便快速调用。
3.3 数据可视化与分析
- 生成图表：在查询结果网格中，点击
Charts -> Create Chart，可选择柱状图、折线图、饼图等类型对结果集进行可视化。 - 数据透视表：在结果网格中，点击
Tools -> Pivot Table，可通过拖拽字段进行多维度数据分析。
四、常见问题与解决方案
问题1：连接数据库时出现“通信链路失败”或超时错误。
解决方案：
- 确认数据库服务正在运行且网络可达。
- 检查连接参数（主机名、端口）是否正确。
- 对于远程数据库，确认防火墙是否放行了对应端口。
- 尝试在连接设置中调整“连接超时”时间为更长的值。
问题2：执行 UPDATE/DELETE 语句时，提示“处于只读模式”或无权限。
解决方案：
- 检查连接使用的数据库用户是否拥有足够的读写权限。
- 确认在连接属性中未勾选“只读连接”选项（在编辑连接设置中查看）。
- 对于某些数据库（如 SQLite），检查文件路径的写权限。
问题3：SQL 编辑器反应迟钝或自动补全不工作。
解决方案：
- 尝试清理编辑器缓存：
Tools -> Options -> General -> Clear Cache。 - 检查自动补全设置：
Tools -> Options -> SQL Editor -> Code Completion，确保相关选项已启用。 - 对于大型数据库，禁用“自动加载元数据”可能提升性能，可在连接属性中设置。
问题4：导出 CSV 文件时中文出现乱码。
解决方案：
- 在导出对话框的“选项”中，明确设置文件编码为 UTF-8。
- 检查源数据库的字符集设置，确保查询结果本身编码正确。
五、RazorSQL for Mac 快捷键汇总表
| 功能分类 | 操作描述 | Mac 快捷键 |
|---|---|---|
| 文件与编辑器 | 新建 SQL 编辑器 | Command + N |
| 打开文件 | Command + O | |
| 保存当前编辑器内容 | Command + S | |
| 关闭当前标签页 | Command + W | |
| 查询执行 | 执行当前语句（光标所在或选中） | Command + Enter |
| 执行编辑器内所有语句 | Command + Shift + Enter | |
| 停止正在执行的查询 | Command + . | |
| 格式化 SQL 代码 | Command + Shift + F | |
| 清除结果面板 | Command + Shift + L | |
| 编辑操作 | 注释/取消注释行 | Command + / |
| 代码自动补全 | Control + Space | |
| 查找 | Command + F | |
| 替换 | Command + H | |
| 导航与视图 | 切换连接导航面板显示/隐藏 | Command + Shift + D |
| 在数据库对象中查找 | Command + Shift + O | |
| 切换到下一个编辑器标签页 | Control + Tab | |
| 数据操作 | 提交数据网格中的编辑 | Command + S (在编辑网格中) |
| 在数据网格中刷新数据 | Command + R |
通过以上详细的界面解析、操作流程、技巧与问题解决方案，您可以快速掌握 RazorSQL for Mac 的核心使用方法，并将其高效地应用于日常的数据库管理和开发工作中。
“`
