在 Linux 上安装 Paneflow

通过 .deb、AppImage 或 tarball 在 Ubuntu、Debian、Fedora、Arch 或任何现代 Linux 上安装 Paneflow。

Linux 上有三条安装路径：一个 .deb 包、一个 AppImage 和一个原始 tarball。选择与你的发行版以及你对系统管理包的容忍度匹配的方式。 AppImage 是通用默认选项，不需要 root 权限。

Linux 构建需要 Vulkan。在 Wayland 上，安装你所在发行版的 Vulkan 加载器（Debian 系是 libvulkan1，Fedora 是 vulkan-loader，Arch 是 vulkan-icd-loader）。.deb 包会替你声明这个依赖以及其他 GUI 前提；AppImage 和 tarball 则要求它们已经存在。

如何在 Ubuntu 或 Debian 上安装 Paneflow？

从最新版本下载与你架构匹配的 .deb，然后用 apt 安装。这个包声明了它的系统依赖（libvulkan1、libxcb1、libxkbcommon0、libfontconfig1 以及其他若干个），因此 apt 会拉取你所缺少的一切。

curl -LO https://github.com/ArthurDEV44/paneflow/releases/download/v0.2.17/paneflow-0.2.17-x86_64.deb
sudo apt install ./paneflow-0.2.17-x86_64.deb

针对 ARM64（Raspberry Pi 5、Ampere、AWS Graviton），把 x86_64 换成 aarch64：

curl -LO https://github.com/ArthurDEV44/paneflow/releases/download/v0.2.17/paneflow-0.2.17-aarch64.deb
sudo apt install ./paneflow-0.2.17-aarch64.deb

二进制文件落在 /usr/bin/paneflow。之后用 sudo apt remove paneflow 卸载。

如何把 Paneflow 作为 AppImage 安装？

AppImage 是一个单文件可执行程序，能在任何现代 Linux 上运行。不需要 root、不需要包管理器、没有安装步骤。

curl -LO https://github.com/ArthurDEV44/paneflow/releases/download/v0.2.17/paneflow-0.2.17-x86_64.AppImage
chmod +x paneflow-0.2.17-x86_64.AppImage
./paneflow-0.2.17-x86_64.AppImage

Ubuntu 24.04 和其他较新的发行版默认不再附带 FUSE 2，会拒绝挂载 AppImage。如果你看到 dlopen(): error loading libfuse.so.2，使用 extract-and-run 回退方式运行：

./paneflow-0.2.17-x86_64.AppImage --appimage-extract-and-run

或者一次性安装 FUSE 2：sudo apt install libfuse2t64。

要从任意位置启动，把 AppImage 移动到 ~/.local/bin 并重命名：

mkdir -p ~/.local/bin
mv paneflow-0.2.17-x86_64.AppImage ~/.local/bin/paneflow
chmod +x ~/.local/bin/paneflow

如何从 tarball 安装 Paneflow？

当你想完全控制二进制文件的位置，或者在做一次非交互式安装的脚本时，使用 tarball。

curl -LO https://github.com/ArthurDEV44/paneflow/releases/download/v0.2.17/paneflow-0.2.17-x86_64.tar.gz
tar -xzf paneflow-0.2.17-x86_64.tar.gz
mkdir -p ~/.local/bin
mv paneflow ~/.local/bin/
chmod +x ~/.local/bin/paneflow

tarball 解压出单一的 paneflow 二进制文件。把它放到 PATH 上的任何位置。如果 ~/.local/bin 还不在 PATH 上，请参见下面的故障排除部分。

如何验证安装？

运行 paneflow --version。预期输出：

paneflow 0.2.x

如果看到版本号被打印出来，说明二进制文件在 PATH 上，GPU 依赖也已就绪。用以下命令启动编辑器：

paneflow

首次运行会打开一个空的工作区，包含一个单独的 shell 窗格。按 Ctrl+Shift+D 水平分屏，或按 Ctrl+Shift+E 垂直分屏。

如果在我的 PATH 上找不到 `paneflow` 怎么办？

如果 paneflow --version 返回 command not found，说明二进制文件不在你 shell 的 PATH 上。这几乎总是因为你走了 tarball 或 AppImage 路径并把二进制文件放进了 ~/.local/bin，而某些发行版默认不会把它加入 PATH。

每个 shell 加一次：

bash（~/.bashrc）：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

zsh（~/.zshrc）：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

fish（~/.config/fish/config.fish）：

fish_add_path ~/.local/bin

fish_add_path 会持久化到通用变量 fish_user_paths，因此这个修改能跨重启保留。打开一个新终端让它在当前会话中生效。

然后重新运行 paneflow --version。如果仍然失败，确认二进制文件可执行（ls -l ~/.local/bin/paneflow 应该显示 -rwxr-xr-x），并且你复制的是二进制文件本身，而不是 .tar.gz。