opencode.nvim

环境要求

• Neovim（需支持 vim.pack 的较新版本）
• 已安装并可运行的 OpenCode（插件本身只是集成层）
• 插件管理器任选：vim.pack（Neovim 内置）、lazy.nvim 或 nixvim（Nix 用户）
• 纯 Lua 插件，无需编译或额外运行时

安装与启动步骤

1. 1准备 OpenCode 本体

   插件只负责把 OpenCode 接入 Neovim，需先去官网 https://opencode.ai/ 安装 OpenCode，并确认终端中能正常运行。

2. 2用 vim.pack 安装(推荐)

   把插件加入 vim.pack 清单，version 指定最新稳定版；写入你的 Neovim 配置文件后重启生效。

   vim.pack.add({
     {
       src = "https://github.com/nickjvandyke/opencode.nvim",
       version = vim.version.range("*"),
     },
   })

   复制

3. 3改用 lazy.nvim 安装

   如果你用 lazy.nvim，则用左侧插件规格替代 vim.pack；两种方式二选一，不要同时装。

   {
     "nickjvandyke/opencode.nvim",
     version = "*",
     config = function()
       vim.g.opencode_opts = {}
     end,
   }

   复制

4. 4Nix 用户安装方式

   使用 nixvim 的用户直接在 extraPlugins 中引用 pkgs.vimPlugins.opencode-nvim 即可。

   programs.nixvim = {
     extraPlugins = [
       pkgs.vimPlugins.opencode-nvim
     ];
   };

   复制

5. 5配置插件选项

   通过全局变量 vim.g.opencode_opts 传入配置；README 说明默认体验已经很完整，可留空使用默认值。

   vim.g.opencode_opts = {
     -- Your configuration, if any
   }

   复制

6. 6设置推荐按键映射

   复制 README 提供的映射，即可用 提问、 选择提示词、go 追加代码范围等。可按需改键。

   vim.keymap.set({ "n", "x" }, "", function() require("opencode").ask("@this: ") end, { desc = "Ask OpenCode…" })
   vim.keymap.set({ "n", "x" }, "", function() require("opencode").select() end, { desc = "Select OpenCode…" })
   vim.keymap.set({ "n", "x" }, "go", function() return require("opencode").operator("@this ") end, { desc = "Append range to OpenCode", expr = true })
   vim.keymap.set({ "n" }, "goo", function() return require("opencode").operator("@this ") .. "_" end, { desc = "Append line to OpenCode", expr = true })
   vim.keymap.set({ "n" }, "", function() require("opencode").command("session.half.page.up") end, { desc = "Scroll OpenCode up" })
   vim.keymap.set({ "n" }, "", function() require("opencode").command("session.half.page.down") end, { desc = "Scroll OpenCode down" })

   复制

关键配置

如何确认成功

在 Neovim 中按 ，能弹出 OpenCode 提问输入界面并正常返回结果，即集成成功。

常见问题

注意事项

• 插件可连接任意已有 OpenCode 服务，也可启动集成实例，连接细节见仓库配置类型说明。
• version = "*" 表示使用最新稳定版，需要尝鲜可自行调整。
• 修改按键映射或配置后需重启 Neovim 或重新加载配置才生效。