10分钟从零到连上第一个数据库：Beekeeper Studio全平台环境搭建教程-编程实验室

10分钟从零到连上第一个数据库：Beekeeper Studio全平台环境搭建教程

【免费下载链接】beekeeper-studioModern and easy to use SQL client for MySQL, Postgres, SQLite, SQL Server, and more. Linux, MacOS, and Windows.项目地址: https://gitcode.com/GitHub_Trending/be/beekeeper-studio

Beekeeper Studio是一款开源跨平台SQL客户端，可以连接MySQL、PostgreSQL、SQLite、SQL Server等数据库。这篇文章是它的Beekeeper Studio安装与环境搭建教程：读完你能在Windows、macOS、Linux任意系统上独立完成安装，连上第一个数据库并跑通第一条查询。

上图就是目标状态：左边是保存的连接，中间是SQL编辑器，底下是查询结果。接下来的流程，就是带你走到这一步。

动手前三项自检

同样的安装，有人顺利有人翻车，通常是因为没确认这3件事，花30秒过一遍：

1. 什么系统、什么芯片？

Windows：目前只支持x86_64，ARM64的Windows暂不可用；
macOS：Intel和Apple Silicon（M系列）两个版本都有，下载时得选对应自己芯片的那份；
Linux：x86-64（大多数电脑）和ARM64（如树莓派）都支持。

为什么强调芯片：macOS装错版本一般也能打开（靠系统转译），但性能打折，个别数据库的驱动库会直接缺失。

2. 有没有管理员权限？

Linux如果是没有root的办公机，直接选AppImage：不安装、不写系统目录。DEB/RPM/Snap这些包方式都需要sudo。

3. 准备连哪种数据库？

本地SQLite文件是验证路径最短的；远程MySQL/PostgreSQL则要等装完再填主机、端口和账号。先想清楚这点，验证环节才能一步到位。

需要更细的官方步骤时，随时可以查官方安装文档。

难度一：一键就能跑通

最快的路线。只看自己系统的小节，不用交叉阅读。

Windows 两步装完

从官网下载Windows安装包，双击按向导走流程——和装任何Windows软件没区别；向导卡住多半是安全软件在拦截，放行即可。另外官网提供便携版，免安装直接运行，适合用U盘在多台机器间搬着用。

macOS：先选芯片再两步装

先在下载页选对芯片版本——Apple Silicon还是Intel。⚠️ 这是全程最容易选错的一步：装错了通常也能靠系统转译运行，但性能和兼容性都会受损。更麻烦的是，若要连Oracle，必须装Intel版本，因为Oracle相关库暂不支持Apple Silicon，要在系统里启用Rosetta 2运行，细节见macOS安装文档。

然后两步：

打开dmg文件，把Beekeeper Studio拖进"应用程序"文件夹。macOS上这一步才等于"安装"，跳过它的话应用只能临时从dmg里跑；
首次启动如果提示"无法打开"，别慌，这是macOS默认拦截App Store之外的应用。去"系统设置 → 隐私与安全性"点"仍要打开"即可。

Linux AppImage 一条命令部署

没有root、或想要各发行版体验最一致的，官方推荐AppImage：相当于"万能钥匙"，还自带自动更新。

给下载好的文件加上执行权限——Linux区分"可读"和"可执行"，少这一步，双击会报无法执行：

chmod +x Beekeeper-Studio-*.AppImage

Ubuntu用户还需要先装fuse库，否则AppImage启动会报错。22.04以下版本执行：

sudo apt-get install fuse libfuse2

22.04及以上只需：

sudo apt install libfuse2

难度二：包管理器安装（带自动更新）

打算长期用的话，走仓库更省心：系统帮你保持更新，不用每次手动下新版。

Debian/Ubuntu（DEB）

第一条命令导入官方GPG密钥并写入软件源，密钥的作用是校验软件包没被篡改，别跳过：

curl -fsSL https://deb.beekeeperstudio.io/beekeeper.key | sudo gpg --dearmor --output /usr/share/keyrings/beekeeper.gpg && sudo chmod go+r /usr/share/keyrings/beekeeper.gpg && echo "deb [signed-by=/usr/share/keyrings/beekeeper.gpg] https://deb.beekeeperstudio.io stable main" | sudo tee /etc/apt/sources.list.d/beekeeper-studio-app.list

然后刷新源并安装：

sudo apt update && sudo apt install beekeeper-studio -y

Fedora/RHEL（RPM）

先写入仓库配置并导入公钥（目的同样是校验来源可信）：

sudo curl -o /etc/yum.repos.d/beekeeper-studio.repo https://rpm.beekeeperstudio.io/beekeeper-studio.repo sudo rpm --import https://rpm.beekeeperstudio.io/beekeeper.key

再安装，老系统把dnf换成yum：

sudo dnf install beekeeper-studio

Snap 一句提醒

Ubuntu用户可以直接执行sudo snap install beekeeper-studio，但注意：受沙箱限制它缺一些功能，新一点的GNOME上还会在选文件界面出现字体发虚。遇到就换回AppImage，详见Linux安装文档。

连接验证：怎么算装好了

"装完"不等于"能用"。咱们用SQLite做一次零门槛验证——它不依赖任何远程服务，能通就证明应用本身没问题。

打开Beekeeper Studio，点"新建连接"；
连接类型选SQLite，在"Database File"旁点"Create"，挑个位置新建一个数据库文件——本地建文件，不用申请任何远程资源；
给连接起个名字，先点"Test"确认文件可读，通过后再点"Connect"。

左侧切到文件列表、没有红色报错，说明第一个数据库连接成立。再开个查询页执行select 1;，有结果返回，环境就算彻底就绪。之后连真实数据库，只是多填主机、端口和账号，操作完全一样。

翻车急救包

卡住了先按症状对号入座，命中率不低：

macOS提示"无法打开"：系统设置 → 隐私与安全性，点"仍要打开"。这是默认安全策略，不是包损坏。

Linux上AppImage起不来：多半是没执行权限或缺依赖。补跑一次chmod +x，Ubuntu的话装libfuse2。

Snap版本字体发虚、发花：已知渲染问题，不怪你的系统，直接换AppImage。

Snap版走SSH隧道读不了密钥：Snap默认隔离了~/.ssh目录，不手动开门应用读不到密钥：

sudo snap connect beekeeper-studio:ssh-keys :ssh-keys

Wayland下界面发虚：新建配置文件写入两行，重启应用即可恢复清晰：

touch ~/.config/bks-flags.conf echo "--ozone-platform-hint=auto" >> ~/.config/bks-flags.conf echo "--enable-features=UseOzonePlatform" >> ~/.config/bks-flags.conf

该开关默认关闭（和Nvidia驱动兼容性问题），所以是手动打开。

Apple Silicon要连Oracle：没有捷径，装Intel版并用Rosetta 2运行，目前只有这一条路。