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想把查询快捷键从CtrlEnter换成别的组合第一步不是点设置面板——Beekeeper Studio 的配置文件路径藏得比文档暗示的更深你要按平台找到user.config.ini的确切目录改一个 INI 文件INI 格式——[节名]加key value的纯文本。这篇文章把三个平台、三种角色的 Beekeeper Studio 配置文件路径一次讲清附合并规则、最小配置示例和改完不生效的排查套路。三个平台一张表你的配置文件在哪角色macOSLinuxWindows个人user.config.ini~/Library/Application Support/beekeeper-studio/~/.config/beekeeper-studio/%APPDATA%\beekeeper-studio\机器级system.config.ini/Library/Application Support/beekeeper-studio//etc/beekeeper-studio/%ProgramData%\beekeeper-studio\开发模式local.config.ini项目根目录三平台通用项目根目录三平台通用项目根目录三平台通用最容易搞混的是文件名个人文件叫user.config.ini机器级文件叫system.config.ini一个user一个system目录也不同。把user.config.ini丢进管理员目录等于没改。分角色看路径你属于哪一类个人改配置只认 user 文件macOS~/Library/Application Support/beekeeper-studio/user.config.iniLinux~/.config/beekeeper-studio/user.config.iniWindows%APPDATA%\beekeeper-studio\user.config.ini即C:\Users\用户名\AppData\Roaming\三处路径都不是拍脑袋定的全是 Electron 的app.getPath(userData)按平台展开的结果见 mainPlatformInfo.ts:67。macOS 的~/Library/Application Support、Linux 的~/.configXDG 标准目录、Windows 的%APPDATA%各归其位。如果你只是个人定制记住userData目录这一个位置就够了三个平台都在这。管理员下发策略只认 system 文件macOS/Library/Application Support/beekeeper-studio/system.config.iniLinux/etc/beekeeper-studio/system.config.iniWindows%ProgramData%\beekeeper-studio\system.config.ini这三个路径直接硬编码在源码里按平台 switch 分支mainBksConfig.ts:181-206。Windows 分支取process.env.ProgramData取不到就回退C:\ProgramData。机器级配置优先级高于个人配置所以管理员可以强制统一全公司的设置个人的同名键会被压下去。如果你要给团队统一下发记住/etc/beekeeper-studio这个 Linux 路径就够了它是三个平台里权限模型最典型的一个。本地开发者根目录放一个 local 文件三平台通用项目根目录的local.config.ini仓库里已有占位文件 local.config.ini内容只有一行注释;override default config here只有app.isPackaged为 false 时才走这条分支判断在 mainBksConfig.ts:291-293。开发模式下它同时取代 user 和 system 两个文件不用再分平台找目录。如果你是跑源码起项目的记住apps/studio/local.config.ini这一个文件就够了。三层怎么叠合并机制一次说透想象三层透明玻璃纸摞在灯上。最底下是出厂默认中间是你自己写的最上面是管理员贴的。同一位置的字只透出最上面那层的墨。加载顺序就是叠放顺序顺序层文件1默认打包自带的default.config.ini2个人user.config.ini开发模式为local.config.ini3机器级system.config.ini叠完用_.merge一次性合并后写覆盖先写// BksConfigProvider.ts:305-310 this.mergedConfig _.merge( {}, source.defaultConfig, source.userConfig, source.systemConfig );位置在 BksConfigProvider.ts:305-310。参数顺序写死在代码里管理员层永远压个人层个人层永远压默认层。动手四行配置加一个十秒验证在对应平台的 user 目录里新建文件写满四行[ui.tableTable] pageSize 200 ; 表数据每页显示 200 行 [keybindings.queryEditor] primaryQueryAction[] ctrlOrCmdenter ; 覆盖主查询快捷键改完必须完全退出进程再启动Mac 按CmdQWindows 从托盘图标退出关窗口不算数。验证是否生效有个十秒技巧打开应用日志目录macOS 为~/Library/Logs/beekeeper-studioWindows 为%APPDATA%\beekeeper-studio\logsLinux 为~/.local/share/beekeeper-studio/logs翻最新日志。启动时BksConfig作用域会打印Successfully read config 路径随后还有User config:的完整 JSON改过的键在不在里面一眼可见见 mainBksConfig.ts:311-317。改了不生效的高频原因如果你发现改完重启没变化而且日志里没有Successfully read config这行大概率是路径写错或文件名用了system.config.ini检查文件是否落在上表第一行的 user 目录。如果你发现文件明明存在但配置没加载大概率是 INI 语法断了——节名没加方括号、两侧缺空格、带引号的值没闭合检查启动日志里的Failed reading config报错。如果你发现日志出现了unrecognized-key警告大概率是键名拼错或该键已废弃检查键名是否与 default.config.ini 里的写法一字不差。如果你发现个人文件和机器级文件写了同一个键个人这边永远不生效这是设计行为——system 层优先级最高让管理员改那个键或删掉机器级文件里的对应行。如果你发现写文件时提示没权限大概率是管理员目录的写保护Windows 检查当前账号是否有%ProgramData%子目录写权限Linux 检查/etc/beekeeper-studio是否需要 root。源码入口和延伸阅读mainBksConfig.ts:173-250loadConfig与resolveConfigDir看这里能理解每个平台路径是怎么拼出来的以及开发模式为何读 local 文件。BksConfigProvider.ts:305-310三层合并的唯一入口看这里能理解覆盖关系为什么是那个顺序。mainPlatformInfo.ts:67-72userData的解析含 Windows 便携版PORTABLE_EXECUTABLE_DIR数据改放可执行文件旁的特例。官方配置文档docs/user_guide/configuration.md全量键速查看 apps/studio/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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考