GeoLibre 桌面端安装：Windows、macOS、Linux 5 分钟装完，零踩坑-育师

GeoLibre 桌面端安装：Windows、macOS、Linux 5 分钟装完，零踩坑

【免费下载链接】GeoLibreA lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs in the web browser, on the desktop, on mobile, and inside Jupyter notebooks.项目地址: https://gitcode.com/GitHub_Trending/ge/GeoLibre

GeoLibre 是一个免费开源的轻量级云原生 GIS 平台，本文是一份GeoLibre 桌面端安装教程：覆盖 Windows、macOS、Linux 的全部安装路径，所有命令都按仓库官方文档核对过。如果你是刚拿到仓库、第一次装桌面端的新手，跟着下面走，5 分钟就能装好。

你是哪种情况？先花 3 秒对号入座：

不想碰终端？→ Microsoft Store / Mac App Store，搜索点装，1 分钟结束。
习惯命令行？→ winget / Homebrew / AUR / COPR / Flatpak，各一行命令。
要离线部署或不想写系统？→ 官方安装包或便携版，解压即用。

不管选哪条路，装出来的都是同一个应用：项目文件（.geolibre.json）在 Web、桌面、移动端之间自由互用，不用担心"装错了版本"。

装完打开就是下面这个界面：中间是地图（也支持 3D 地球视角），左侧图层面板、右侧样式面板，日常的建图层、加数据、改样式都在这三块区域里完成。

动手之前：先记住 4 个容易踩的坑

排错内容放最前面，省得你装到一半卡住再翻回来：

Windows 官方 Release 构建未签名：从发布页下载的安装包运行时 SmartScreen 可能警告，别慌，点更多信息 → 仍要运行即可。
Windows 便携版打不开：它依赖 WebView2 运行时，Windows 11 和新版 Win 10 已预装；确实缺失就装 Evergreen 运行时。
macOS 老版本提示不安全：v1.4.1 起已由 Apple 签名并公证，Gatekeeper 直接放行；v1.4.0 及更早版本装完需要移除隔离标记（命令在 macOS 一节）。
AppImage 报 FUSE 错误：装libfuse2（如sudo apt install libfuse2），或加--appimage-extract-and-run参数运行。

Windows：Store 一键装完，终端党用 winget

这个平台上最省事的路径是Microsoft Store。GeoLibre Windows 安装的商店版经过签名，启动时没有 SmartScreen 弹窗，后续还自动更新，对普通用户来说是最省心的一条 GeoLibre 桌面端安装路径。

在 Store 里搜索安装

打开 Microsoft Store，搜索 GeoLibre。
点安装。到这一步就结束，没有别的步骤。

用 winget 一行装好

习惯终端的话，这一步就一行，PowerShell 里执行：

winget install OpenGeos.GeoLibre

它走的是 Windows 官方包管理器，装的是 GitHub Release 构建版，功能和手动下载安装包等价。

另一条路：官方安装包与便携版（不装也能跑）

如果公司内网装不了商店应用，或者其实不想往系统里写东西，直接下最新发布资产：

安装方式：下载.msi/.exe运行，注意前面说的 SmartScreen 提示。
便携方式：下载*-x64-portable.zip，解压到任意位置（U 盘也行），双击geolibre-desktop.exe运行——不需要管理员权限、不写注册表。这个 GeoLibre 便携版不自动更新，升级时下载新 zip 覆盖即可。

macOS：Homebrew 一行装好，不想碰终端用 DMG

这个平台上最省事的路径是Homebrew。GeoLibre 已在官方 Cask 库中，不用加 tap，终端里执行：

brew install --cask geolibre # 安装 brew upgrade --cask geolibre # 升级 brew uninstall --cask geolibre # 卸载

装、升、卸各一行，后面不用惦记更新。DMG 构建用 Apple Developer ID 签名并经公证，Gatekeeper 直接放行。

另一条路：DMG 拖拽安装

按芯片下载对应 DMG（Apple Silicon 选aarch64，Intel 选x64）——GeoLibre macOS 下载时别拿错芯片版本。
打开 DMG，把GeoLibre Desktop拖入Applications。
从应用程序文件夹启动。

还停在 v1.4.0 及更早版本的话，装完执行一次下面这条命令移除隔离标记，每次升级后重复执行：

xattr -dr com.apple.quarantine "/Applications/GeoLibre Desktop.app"

用 Mac App Store 版前要知道的事

商店里搜 "GeoLibre Desktop" 也能装，像普通商店应用一样自动更新。但受沙盒规则限制，商店版砍掉了一部分功能：没有 Python 侧车引擎（GeoPandas、rasterio、GDAL 转换等）、没有 Add Data → PostgreSQL / PostGIS、Notebook 面板只有 JupyterLite、外部插件（zip 或注册表安装）不支持。说白了就是沙盒不允许运行时下载代码，这些功能在编译期就被裁掉了。用得上其中任何一项，就选 Homebrew 或 DMG。

Linux：AUR / COPR / Flatpak 三选一，让包管理器管更新

这个平台上最省事的路径是按发行版选包管理器渠道，三种都会随系统自动更新，不用自己追安装包。

Arch / Manjaro：AUR 二进制包

geolibre-bin是二进制包，直接重打包官方发布版，不需要源码编译：

yay -S geolibre-bin # 或: paru -S geolibre-bin

Fedora / RHEL：COPR

RHEL 及衍生版先装好插件（sudo dnf install dnf-plugins-core），然后两条命令：

sudo dnf copr enable giswqs/geolibre sudo dnf install geolibre

任意发行版：Flatpak（经 FlatPark）

第一条命令只执行一次，把 FlatPark 源加进来；第二条才是安装：

flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo flatpak install flatpark app.geolibre.GeoLibre

这是通用性最好的 GeoLibre Linux Flatpak 装法，之后升级交给flatpak update就行。

另一条路：官方包与 AppImage

发行版没有现成源、或要离线安装时，直接下发布页资产：

# Debian / Ubuntu sudo apt install ./GeoLibre.Desktop_<version>_amd64.deb # 其他 RPM 发行版 sudo dnf install ./GeoLibre.Desktop-<version>-1.x86_64.rpm

AppImage 则通吃所有发行版，加执行权限后直接跑：

chmod +x GeoLibre.Desktop_<version>_amd64.AppImage ./GeoLibre.Desktop_<version>_amd64.AppImage

命令里的<version>换成你实际下载的版本号；老版本升级就是重新下新包覆盖安装，AppImage 则支持.zsync增量更新，只传变化的块。

装完之后的两件事

去哪下资产：官方下载页与发布页按平台分组列出资产并附 SHA-256 校验和；另有一个下载镜像站，专门给 GitHub 访问不畅的地区用。
功能差异：除 Mac App Store 沙盒版外，其余渠道装的都是完整版，包括 1000+ 工具的 Whitebox 工具箱（WASM 本地运行，不依赖 Python）。

至此 GeoLibre 桌面端安装流程全部走完，装完打开建个新地图就能上手。