2.1.3 Linux 系统安装

系统要求

• 主流 64 位 Linux 发行版（内核建议 4.19 及以上）
• glibc 2.28 或更高版本
• 支持 X11 与 Wayland 桌面环境
• 建议预留 500MB 以上磁盘空间

安装方式

Linux 版本通常提供 AppImage、.deb 和 .rpm 三种分发形式，根据你的发行版选择其一即可。

方式一：AppImage（通用，免安装）

适合所有 Linux 发行版，无需 root 权限，不与其他系统包产生冲突。

1. 下载 .AppImage 文件。
2. 打开终端，进入下载目录并赋予执行权限：

   chmod +x CodeBuddy-*.AppImage
   

1. 直接运行：

   ./CodeBuddy-*.AppImage
   

1. （可选）为方便全局调用，可将其移动到 ~/.local/bin（需确保该目录在 PATH 中）并重命名为 codebuddy。

方式二：Debian / Ubuntu（.deb）

1. 下载 .deb 安装包。
2. 执行安装：

   sudo dpkg -i codebuddy-*.deb
   

1. 若提示依赖缺失，执行修复：

   sudo apt-get install -f
   

1. 安装完成后，应用菜单会自动生成快捷方式。

方式三：Red Hat / CentOS / Fedora / openSUSE（.rpm）

1. 下载 .rpm 安装包。
2. 按发行版执行对应命令：

• Fedora / RHEL 8+ / CentOS Stream：

     sudo dnf install ./codebuddy-*.rpm
     

• 旧版 CentOS 7 / RHEL 7：

     sudo rpm -ivh codebuddy-*.rpm
     

• openSUSE：

     sudo zypper install ./codebuddy-*.rpm
     

启动客户端

• 在应用菜单或活动概览中搜索"CodeBuddy"启动。
• 或在终端直接输入 codebuddy 启动（AppImage 需确保已正确放置或建立软链接）。

卸载说明

• AppImage：直接删除 .AppImage 文件即可，用户配置位于 ~/.config/CodeBuddy。
• .deb：

  sudo apt remove codebuddy
  

• .rpm：

  sudo dnf remove codebuddy   # 或 sudo rpm -e codebuddy
  

常见问题

• AppImage 提示缺少 FUSE：部分精简系统未预装 libfuse2。Debian/Ubuntu 可执行 sudo apt install libfuse2 后重试。
• Wayland 下界面显示异常：若遇到字体渲染或窗口兼容问题，可在启动前执行 export QT_QPA_PLATFORM=xcb，强制使用 XWayland 模式运行。
• AppImage 未出现在应用菜单：AppImage 默认不自动创建菜单项，如需集成，可借助 AppImageLauncher 工具，或手动创建 .desktop 文件。