人人都会AI编程

2.1.3 Linux 系统安装

更新时间：2026-06-30

本节面向 Ubuntu、Debian、CentOS、Fedora 等主流 64 位发行版用户（要求 glibc 2.17 及以上）。OpenCode 没有独立的 Linux 客户端，直接在你已有的 IDE 中安装插件即可。

1. 安装 IDE（如尚未安装）

  • VS Code：推荐从官网下载对应系统的安装包（.deb 用于 Debian/Ubuntu，.rpm 用于 CentOS/Fedora/RHEL），使用包管理器安装（例如 sudo dpkg -i code_xxx.deb）。也可通过 Snap 安装：sudo snap install code --classic。
  • JetBrains 系列：推荐下载 JetBrains Toolbox App（.tar.gz），解压后运行其中的 jetbrains-toolbox 可图形化管理各 IDE 的安装与升级。

2. 在 IDE 内安装 OpenCode 插件

Visual Studio Code

  1. 打开 VS Code，按 Ctrl+Shift+X 打开扩展面板。
  2. 搜索 OpenCode，认准蓝色官方认证标识，点击「安装」。
  3. 完成后点击提示中的「重新加载」，或按 Ctrl+Shift+P 输入 Reload Window 手动刷新。

JetBrains 系列

  1. 打开 IDE，按 Ctrl+Alt+S（或菜单 File → Settings）进入设置。
  2. 左侧选择 Plugins，切换到 Marketplace 标签页。
  3. 搜索 OpenCode，点击 Install，完成后按提示重启 IDE。

3. 离线安装（内网/无公网环境）
若办公网无法访问插件市场：

  1. 向管理员获取 Linux 环境下对应的离线包（.vsix 文件对应 VS Code；.zip 对应 JetBrains）。
  2. VS Code：扩展面板右上角 ··· → 从 VSIX 安装... → 选择文件 → 重新加载窗口。
  3. JetBrains：Plugins 界面点击齿轮图标 → Install Plugin from Disk... → 选择文件 → 重启 IDE。

4. 首次配置
重启 IDE 后，右下角一般会弹出配置提示：

  • 账号登录：点击「登录」，系统自动唤起默认浏览器完成授权（支持企业微信、飞书、GitHub 等）。授权成功后通常会自动跳转回 IDE。
  • 私有化部署：点击「手动配置」，输入管理员提供的 API Endpoint 和 Token，点击「连接测试」通过后保存。

Linux 特别提示：若浏览器授权后未能自动唤回 IDE（常见于 Firefox 或 Chromium 环境），可手动复制授权页面返回的 Token，粘贴回 IDE 的输入框完成登录。

5. 验证安装
新建或打开任意代码文件（如 .py、.java、.js），输入部分函数名（例如 def calculate），稍等 1–2 秒，若出现灰色斜体的补全提示，即表示安装成功。

Linux 环境常见问题

  • 安装按钮灰色或搜不到插件：请检查 IDE 版本是否满足最低要求（VS Code ≥ 1.70；JetBrains ≥ 2022.2），必要时从官网升级 IDE。
  • Snap 版 VS Code 无法读取系统 SDK：Snap 处于沙盒环境，可能导致插件无法获取系统环境变量或本地工具链路径，建议改用 .deb/.rpm 包安装。
  • JetBrains IDE 中文显示方块或字体异常：在 Settings → Appearance & Behavior → Appearance 中，将 UI 字体改为系统自带的中文字体（如 Noto Sans CJK SC），或安装文泉驿、思源黑体等字体后重启。
  • Wayland 会话下快捷键或粘贴异常：可尝试在启动 VS Code 时添加 --enable-features=WaylandWindowDecorations --ozone-platform=wayland 参数，或临时切换至 Xorg 会话再试。