企业官网建设流程全解析

Beekeeper Studio 配置文件在哪？user.config.ini 与 system.config.ini 速查指南

【免费下载链接】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 是一款支持 MySQL、Postgres、SQLite 等数据库的跨平台 SQL 客户端，它的行为可以靠 INI 格式的配置文件（纯文本、按分节写键值对）来定制。核心答案先给你：个人定制改user.config.ini，整台机器统一管控改system.config.ini，两者放在各自的系统目录里，改完必须重启应用才生效。

三个平台分别该改哪个文件？📍

先记住一个反直觉的点：用户文件和管理员文件的名字不一样，一个是user.config.ini，一个是system.config.ini，找错名字是新人最常踩的坑。

补充两点：

• %APPDATA%展开后就是C:\Users\<用户名>\AppData\Roaming；
• 管理员文件在代码里是硬编码的系统目录（见 mainBksConfig.ts），文件不存在时只记一条警告、返回空对象，不会让应用启动失败。

另外有个容易忽略的特例：如果你用的是Windows 便携版（设置了PORTABLE_EXECUTABLE_DIR），数据会放在可执行文件旁的beekeeper_studio_data目录里，配置位置也随之变化。

我只想改自己的设置：最短操作路径 ⚙️

典型诉求：调大表格每页行数、改执行查询的快捷键、连接超时……这些都属于个人偏好，只动用户文件。

1. 定位文件：按上表找到你系统对应的user.config.ini（macOS 和 Linux 上目录可能还不存在，手动新建即可）。
2. 写入 INI：分节名用[方括号]包住，=两边留空格，;开头是注释。最小示例（每页多显示点行 + 换一组执行快捷键）：

; 我的 Beekeeper Studio 用户配置 [ui.tableTable] pageSize = 200 [keybindings.queryEditor] primaryQueryAction[] = ctrlOrCmd+enter

3. 完全退出并重启应用，新设置生效。

想确认某个键名到底能不能用？直接翻随应用分发的 default.config.ini，里面按[general]、[security]、[ui.*]、[db.*]、[keybindings.*]列出了全部可用项和默认值，是最权威的速查表。

我要统一管控整台机器：走管理员文件 🏢

场景换了：你是 IT 管理员，想让这台机器上所有用户的 Beekeeper Studio 都遵守同一套安全策略。这时候用户文件说了不算，你要的是优先级更高的机器级文件。

1. 在对应平台的管理员目录（上表第三列）创建system.config.ini，写法与用户文件完全相同。
2. 重启后，凡是 system 文件里出现的键，一律以 system 为准，用户在user.config.ini里写什么都覆盖不了。

也就是说，企业下发一份system.config.ini就能强制锁定某些设置——这就是它存在的意义。完整路径表见官方文档 config_file_directories。

底层规则：默认 → 用户 → 管理员，后写者赢 🧱

把配置想象成三张叠在一起的便利贴：

• 最底层是默认贴（default.config.ini，随应用打包，你改不了它本体，但启动时会被复制一份到你目录供参考）；
• 中间是用户贴（user.config.ini，你自己的偏好）；
• 最上面是管理员贴（system.config.ini，整机策略）。

应用启动时把三张贴按"默认 → 用户 → 管理员"的顺序合并，同一位置的键以上面的贴为准。实现就在 BksConfigProvider.ts 的一次合并调用里，效果等价于：管理员覆盖用户、用户覆盖默认。

还有个"第四贴"只属于开发者：如果你 clone 了源码仓库并在开发模式下跑（应用未打包，app.isPackaged为 false），程序会读项目根目录的 local.config.ini——仓库里已有一个只含注释;override default config here的示例文件，它同时取代用户贴和管理员贴。这个文件只在开发期间有效，发布版根本不认它。

配置不生效？对着这 6 条逐项排查 🔍

完整排查思路见官方文档 Configuration。

一句话收尾

记住"平台固定目录 + 固定文件名 + 后写者赢"这三点，配置问题就没有解决不了的；想改什么键，直接查 default.config.ini 的全量清单即可。

【免费下载链接】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