# 关于

pgAdmin III是最受欢迎的PostgreSQL开源管理和开发平台。原项目已停止开发，转而支持基于Web的pgAdmin 4，但这个社区分支延续了原生wxWidgets应用程序的生命——为现代PostgreSQL版本修复错误并添加了数十项新功能。

本版本引入了适用于Apple Silicon（arm64）的完全原生macOS移植版，通过Homebrew Cask作为自包含的.app捆绑包分发。

License: PostgreSQL许可证（宽松的BSD式许可证）
仓库: github.com/heptau/pgadmin3
上游分支: levinsv/pgadmin3 (支持PostgreSQL 18)
原始项目: postgres/pgadmin3 (archived)

# 截图

# 主要功能

🖥️ 原生macOS

基于wxWidgets 3.3 + Cocoa构建的真正原生应用。无需Electron，无需Java——内存占用低，启动速度快。

🐘 PostgreSQL 12–18

全面支持最新PostgreSQL版本、PostgresPro Enterprise、Slony-I复制以及pgAgent调度。

🔍 SQL编辑器

语法高亮、光标下语句自动识别、自动保存标签页、多结果窗口、PCRE文本转换。

📊 查询工具

命名书签、基于外键的JOIN自动补全、可读性优化的大数字显示、单元格比较差异视图。

🔄 Schema工具

跨服务器对象比较与HTML差异报告、基于GitLab的版本控制、通过amcheck进行B-tree索引检查。

📈 监控

服务器状态/活动窗口、进程高亮、等待事件采样（pg_wait_sampling）、AWR报告、CSV日志查看器。

🎨 SVG工具栏

现代化SVG工具栏图标，支持HiDPI/Retina，可针对不同服务器进行颜色编码。

🌐 本地化

内置45种语言，全部提供可编辑的.po源文件和完整翻译。

🔌 插件

可通过插件模块扩展——无需修改核心即可添加自定义功能。

🔐 SSL / SSH

SSL/TLS连接加密和SSH隧道（libssh2），确保服务器访问安全。

# 安装

macOS（Apple Silicon）— 最快路径

通过Homebrew Cask获取预编译二进制文件：

brew install heptau/tap/pgadmin3

从Launchpad、Spotlight或终端启动：

open /Applications/pgAdmin\ III.app

从源码构建（macOS）

git clone https://github.com/heptau/pgadmin3.git
cd pgadmin3
make build
open "build-macos/pgAdmin III.app"

注意：首次构建需要本地编译的wxWidgets 3.3（使用--disable-std_containers）。Homebrew的预编译包不兼容——详情请参阅AGENTS.md。

Linux

git clone https://github.com/heptau/pgadmin3.git
cd pgadmin3
make build
./build/pgAdmin3

Windows

在Visual Studio中打开pgAdmin3.vcxproj，或在Linux上使用mingw进行交叉编译——请参阅INSTALL_EN.txt。

或从GitHub releases页面获取预编译的便携版zip（pgAdmin3-<version>-windows-x64.zip）——无需构建工具，只需解压并运行pgAdmin3.exe即可。注意：此zip是从上游levinsv/pgadmin3分支的二进制文件构建的，因此可能不包含本项目macOS构建中的所有修复——但它捆绑了本项目维护的额外语言和guru-hint文档。

# 更新内容

v2026.09.22

服务器属性显示选定的 postgresql.conf 参数（包括待重启生效的值）和服务器标签
可将剪贴板中 Key=Value 格式的连接信息直接粘贴到“新建服务器”对话框
可选的函数依赖视图 —— 在“依赖关系”选项卡中显示函数/过程引用的表、视图和函数
Linux/GTK 深色模式，覆盖结果表格、EXPLAIN 计划等，颜色可配置
对无特权 PostgreSQL 用户的基本支持
修复：plpgsql 依赖解析器、以 _ 开头的标识符、JSON 树崩溃、F4 快速查找窗口

v2026.08.16

可选的加密操作系统凭据库，用于保存服务器密码
far2l 集成（通过 NetRocks）
每个 GitHub 发布版均提供便携式 Windows zip

v2026.08.07

以 PostgreSQL COPY 格式导出到文件
比较对话框改为逐行比较，差异报告更清晰
修复结果表格中的 Alt+E，以及在查询运行中再次执行导致的崩溃

v2026.07.21 及更早版本

全部 45 种语言翻译完成，附带可编辑的 .po 源文件
18 种语言的 guru 提示文档
通过 Homebrew Cask 提供原生 macOS 版本（arm64），深色 / 浅色模式实时切换，Retina 图标
支持 PostgreSQL 18

完整更新日志： CHANGELOG.md

# 支持与文档

错误报告和功能请求 — GitHub Issues
AGENTS.md — macOS移植工作笔记
INSTALL_EN.txt — 详细构建说明
CHANGELOG.md — 完整变更历史