文档/ 入门/ 快速开始
Getting Started

快速开始

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

下载与安装

MagicDB Studio 提供 Windows、macOS(Intel / Apple Silicon)与 Ubuntu/Linux 客户端包,内嵌 JRE 运行环境,无需单独安装 Java

平台安装包说明
Windows 10/11Magic-DB-AI-Setup-2026.9.1502.exe推荐;NSIS 安装程序,自动创建快捷方式
Windows 10/11Magic-DB-AI-Portable-2026.9.1502-win-x64.zip免安装;完整解压后运行 MagicDB Studio.exe
macOS IntelMagic-DB-AI-2026.8.1101-x64.dmg拖入「应用程序」文件夹
macOS Apple SiliconMagic-DB-AI-2026.8.1101-arm64.dmgM 系列芯片专用
Ubuntu / LinuxMagic-DB-AI-2026.8.2101.AppImage赋予执行权限后直接运行,另有 deb 包
Windows ZIP 版提示:请先将压缩包完整解压到普通文件夹,再运行 MagicDB Studio.exe;不要直接在压缩包预览窗口中启动。macOS 首次打开若提示「身份不明的开发者」,参见 FAQ

创建第一个连接

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

界面导览

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

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

下一步