MagicDB Studio 标志 MagicDB Studio 内测版
文档/ 入门/ 快速开始
Getting Started

快速开始

从下载到跑通第一条查询，5 分钟上手 MagicDB Studio。

下载与安装

MagicDB Studio 提供 Windows、macOS（Intel / Apple Silicon）与 Ubuntu/Linux 安装包，内嵌 JRE 运行环境，无需单独安装 Java。

平台安装包说明
Windows 10/11Magic-DB-AI-Setup-1.0.1.exeNSIS 安装程序，双击按向导完成
macOS IntelMagic-DB-AI-1.0.1-x64.dmg拖入「应用程序」文件夹
macOS Apple SiliconMagic-DB-AI-1.0.1-arm64.dmgM 系列芯片专用
Ubuntu / LinuxMagic-DB-AI-1.0.1.AppImage赋予执行权限后直接运行，另有 deb 包
提示：前往 下载页 获取对应平台安装包。macOS 首次打开若提示「身份不明的开发者」，参见 FAQ。

创建第一个连接

  1. 启动应用，进入「连接中心」，点击 新建连接。
  2. 选择数据库类型（如 MySQL），填写主机、端口、账号密码。
  3. 点击 测试连接 确认连通后保存。
  4. 双击连接即可展开对象树，开始浏览库表。
新建连接 · MySQL
创建 MySQL 连接的配置表单：主机、端口、账号、密码
新建连接表单：填写主机、端口、账号密码，点「测试连接」验证连通性后保存。
提示：内置 11 类数据库开箱即用；其余类型可先到「驱动中心」下载对应 JDBC 驱动模板。SSH 隧道、SSL、云数据库预设等详见 连接管理。

界面导览

主界面默认进入 SQL 工作台：左侧为连接与对象树，中间是 Monaco 编辑器，底部展示执行结果。顶部导航可切换到连接中心、AI 助手、工具中心、SQL 历史与设置。

SQL 工作台 · 主界面
SQL 工作台主界面：左侧对象树、中间编辑器、底部结果集
SQL 工作台主界面：左侧对象树按连接名称与数据库类型图标组织，中间编辑器支持多 Tab，底部为结果集区。

下一步