在 Linux 上构建和安装 CodeBuddy IDE

GitHub 项目地址：JipZeonGit/codebuddy-ide-cn-linux

免责声明：本项目为非官方社区开源工具，与腾讯官方无任何关联。CodeBuddy IDE CN 是腾讯旗下产品（版权 © 2026 腾讯云计算（北京）有限责任公司丨腾讯科技（深圳）有限公司 版权所有）。本工具不分发任何 CodeBuddy IDE CN 官方软件，仅自动化实现用户对自有正版安装包的格式转换流程。

遇到任何 Bug 请在 GitHub 仓库提 issue ，严禁跳脸向官方客服反馈在 Linux 移植后使用的相关问题。

理论来说适配 apt、pacman、dnf5、dnf、zypper 等多种包管理器。（目前我使用的系统是Debian分支，只能测试了 apt）

X11 和 WayLand 桌面环境能够正常使用，但是我只能测试了 X11 没有任何问题。如果在 WayLand 遇到 Fcitx 5 输入不了的问题，建议检查一下系统配置。

内置 --ozone-platform-hint=auto 自动检测桌面环境，优先使用 WayLand，如果无法使用会回退到 X11，内置 --enable-wayland-ime ，启用 WayLand 桌面环境下对 IME 输入法的支持。

使用教程

1. 先拉取项目仓库，然后在项目的根目录内创建一个 downloads 文件夹，去 CodeBuddy IDE 官网下载 MacOS intel x64 的 DMG 包，把它放进 downloads 文件夹。

   注意：downloads 文件夹只能放一个 DMG，如果之后有版本更新，请删除掉旧版的 DMG 放新版的进去。

2. 在项目根目录打开终端，输入 bash scripts/install-deps.sh 准备依赖环境。

3. 输入 make build-app 构建

4. 输入 make package 打包

5. 输入 make install 安装

视频教程

B站：BV11nRmB1EQq

前言：最近在工作电脑把系统换成了 Linux Mint 22.3（Debian分支），使用 AI Coding 发现 CodeBuddy IDE 没有 Linux 版本。

于是参考了一个 GitHub 开源项目 ilysenko / codex-desktop-linux，研究了它是怎么把 Codex Desktop 移植到 Linux 上。

简单来说它是 Electron 应用，先获取到 MacOS 版本的 DMG 安装包，借助 7z/7zz 脱壳，然后剔除掉 MacOS 的 Electron Runtime 和 MacOS 相关的组件，换成 Linux 原生的 Electron Runtime 和 Linux 原生的组件，再进行打包。

于是，我研究了 CodeBuddy IDE 也是 Electron 应用，应该也可以移植到 Linux 上使用，我仿照了 codex-desktop-linux 的移植思想，借助 Codex 和 Antigravity 完成了 CodeBuddy IDE 的移植，用 AI 来给 AI IDE 移植，这很正常对吧！

研究过程

1. 第一版移植完成后，进行了1个小时高强度GLM 5.1的使用，发现左下角经常提示 pty 主机进程没有响应 ，于是去调查是什么问题。

2. node-pty 是 VS Code 的一个极其重要的 C++ 原生模块，VS Code（CodeBuddy的架构）UI 界面是跨平台的网页代码，但是终端的功能不可能用纯 JS 实现。为了让网页的终端能够像真正的 Linux 命令行一样输入指令、监听输出，VS Code 内深度依赖 node-pty 原生模块。

3. 初版移植出现 pty 主机进程没有响应 ，本质上是因为在转换打包的过程中，node-pty 模块没有被完美针对 Linux 环境和 Electron 版本重新编译。主进程在调用底层的 pty 模块时，没有获得响应。

4. 原因：官方在打包 MacOS DMG 时，为了极限压缩体积，会把 C++ 的源码（.cpp）和构建图纸（binding.gyp）全部删掉，只保留编译好的 Mac 版二进制 .node 文件！导致在移植的时候 @electron/rebuild 在 Linux 上直接“装死”。

5. 解决方法：直接去 npm 官方源拉取 node-pty 完整源码，在 Linux 的临时目录里重新编译完，然后再塞回去就好了。

最后完美移植完成，如果喜欢这个项目，可以点个 Star 支持，如果在使用中有别的问题，欢迎在 GitHub 报 issue 或者 在评论区留言，谢谢您的支持！