改了 pageSize 重启却原样不动Beekeeper Studio 配置文件的 4 个位置一次说清【免费下载链接】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-studioBeekeeper Studio 是一个管理 MySQL、Postgres、SQLite 等数据库连接的桌面客户端。想把界面、快捷键调成自己喜欢的样子却不知道配置文件该放哪就是本文要解决的事从个人定制到企业统管一共 4 条路径以及它们如何合并生效。从改了没生效说起先还原一个常见场景你在某个 INI 文件里写了pageSize 200重启应用表格还是每页 100 行。九成概率是文件放错地方了。Beekeeper Studio 到哪些目录找配置是写死在源码里的没法让它换个地方再找找查找位置不可配置。先补一句背景这里的 INI 就是[节名]加key value的纯文本什么依赖都不需要。另外文件名分两套——用户级叫user.config.ini管理员级叫system.config.ini别把这两个名字搞混放对内容但用错文件名等于没放。三平台路径按你要改谁来查 查路径之前先问一句你是只改自己的机器还是要统管一批机器只改自己 → 动用户文件IT 管理员统一管控 → 动管理员文件。想清楚改谁再对着平台查表就行角色平台配置文件路径用户个人macOS~/Library/Application Support/beekeeper-studio/user.config.ini用户个人Linux~/.config/beekeeper-studio/user.config.ini用户个人Windows%APPDATA%\beekeeper-studio\user.config.ini管理员ITmacOS/Library/Application Support/beekeeper-studio/system.config.ini管理员ITLinux/etc/beekeeper-studio/system.config.ini管理员ITWindowsC:\ProgramData\beekeeper-studio\system.config.ini两个细节Windows 的%APPDATA%展开后就是C:\Users\用户名\AppData\Roaming管理员目录取自ProgramData环境变量没设置时回退到C:\ProgramData。还有个表格外的重要特例——Windows 便携版一旦设置了PORTABLE_EXECUTABLE_DIR整套数据包括配置目录会挪到可执行文件旁边的beekeeper_studio_data目录里官方文档的表格里没提这一点。开发者的第 4 个文件local.config.ini开发期才存在如果你是从源码跑应用还有个别人用不上的文件把local.config.ini放在项目根目录即可仓库里已带了一份示例apps/studio/local.config.ini内容就一行注释;override default config here照着往里填。它的特殊性在于一个顶俩开发期它同时取代用户文件和管理员文件。开关是 Electron 的app.isPackaged——为false时源码里对应platformInfo.isDevelopment加载逻辑就指向local.config.ini打包好的正式版则照旧读user.config.ini。所以别指望在已安装的客户端上找到它的身影。谁说了算Default → User → Admin三层文件的加载顺序是默认基线default.config.ini随应用分发→ 用户配置 → 管理员配置。谁压过谁答案在apps/studio/src/common/bksConfig/BksConfigProvider.ts里那一行_.merge({}, defaultConfig, userConfig, systemConfig)lodash 的merge是后面的参数覆盖前面的所以优先级链是 管理员 用户 默认。这也是企业玩法的底气IT 只要往机器级下发一份system.config.ini个人文件里的设置就被强制压住了。加载链路还有两处值得知道apps/studio/src/common/bksConfig/mainBksConfig.ts里的resolveConfigDir()决定用户目录生产环境取platformInfo.userDirectory开发环境取项目根目录好去读local.config.iniloadConfig()则按平台 switch 出管理员目录并在非开发环境下把打包自带的default.config.ini复制一份到用户目录方便你随时对照。而userDirectory本身来自mainPlatformInfo.ts里 Electron 的app.getPath(userData)所以 macOS 是~/Library/Application Support、Linux 是~/.config、Windows 是 Roaming 目录。动手第一次写 INI ️一个可以直接照抄的最小示例; 我的 Beekeeper Studio 配置 ; 分号开头的行是注释 [ui.tableTable] pageSize 200 [keybindings.queryEditor] primaryQueryAction[] ctrlOrCmdenter语法上就三件事节标题用[方括号]包起来两侧留空格;开头是注释。最后提醒一个高频坑改完必须完全退出应用再重新打开热重载不算数配置只在启动时读一遍。不生效按这个顺序自查位置对不对对照上面那张表确认文件在当前系统、当前角色的正确目录里。语法有没有毛病节名忘了方括号、拼成、注释写进了值里都会让整份文件读不出来。真的重启了吗完全退出进程再启动别只是关窗口。键名拼写节名和键名拼错一个字应用会当作不存在静默忽略。读权限确认 Beekeeper Studio 进程有权限读那个文件尤其是管理员目录。深度排查开启调试日志看BksConfig这个 scope每个配置文件加载时都会留痕。如果日志里出现unrecognized-key类型的警告说明有个键既不在default.config.ini也不在deprecated.config.ini里基本就是键名写错了。收尾记住一个画面想象三层文件叠在一起默认值随应用出厂用户层是你的管理员层是公司发的开发期再多一个local层顶替上面两层——后写的覆盖先写的改完必须重启。想往下深挖三条路翻apps/studio/default.config.ini看全量配置项读apps/studio/src/common/bksConfig/mainBksConfig.ts看路径解析读apps/studio/src/common/bksConfig/BksConfigProvider.ts看合并逻辑日常使用的话docs/user_guide/configuration.md足够覆盖。【免费下载链接】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），仅供参考