
opencode.nvim
在 Neovim 里无缝调用 AI 编程助手,边写边聊不切屏
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 3920
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Neovim(需支持 vim.pack 的较新版本)
- 已安装并可运行的 OpenCode(插件本身只是集成层)
- 插件管理器任选:vim.pack(Neovim 内置)、lazy.nvim 或 nixvim(Nix 用户)
- 纯 Lua 插件,无需编译或额外运行时
安装与启动步骤
-
1准备 OpenCode 本体
插件只负责把 OpenCode 接入 Neovim,需先去官网 https://opencode.ai/ 安装 OpenCode,并确认终端中能正常运行。
-
2用 vim.pack 安装(推荐)
把插件加入 vim.pack 清单,version 指定最新稳定版;写入你的 Neovim 配置文件后重启生效。
vim.pack.add({ { src = "https://github.com/nickjvandyke/opencode.nvim", version = vim.version.range("*"), }, }) -
3改用 lazy.nvim 安装
如果你用 lazy.nvim,则用左侧插件规格替代 vim.pack;两种方式二选一,不要同时装。
{ "nickjvandyke/opencode.nvim", version = "*", config = function() vim.g.opencode_opts = {} end, } -
4Nix 用户安装方式
使用 nixvim 的用户直接在 extraPlugins 中引用 pkgs.vimPlugins.opencode-nvim 即可。
programs.nixvim = { extraPlugins = [ pkgs.vimPlugins.opencode-nvim ]; }; -
5配置插件选项
通过全局变量 vim.g.opencode_opts 传入配置;README 说明默认体验已经很完整,可留空使用默认值。
vim.g.opencode_opts = { -- Your configuration, if any } -
6设置推荐按键映射
复制 README 提供的映射,即可用 <C-a> 提问、<C-x> 选择提示词、go 追加代码范围等。可按需改键。
vim.keymap.set({ "n", "x" }, "<C-a>", function() require("opencode").ask("@this: ") end, { desc = "Ask OpenCode…" }) vim.keymap.set({ "n", "x" }, "<C-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" }, "<S-C-u>", function() require("opencode").command("session.half.page.up") end, { desc = "Scroll OpenCode up" }) vim.keymap.set({ "n" }, "<S-C-d>", function() require("opencode").command("session.half.page.down") end, { desc = "Scroll OpenCode down" })
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
vim.g.opencode_opts | 否 | 插件配置表,可自定义行为;留空即使用默认配置 | vim.g.opencode_opts = {} |
如何确认成功
在 Neovim 中按 <C-a>,能弹出 OpenCode 提问输入界面并正常返回结果,即集成成功。
常见问题
Q:必须自己先装 OpenCode 吗?
A:需要。opencode.nvim 只是连接层,负责对接 OpenCode 的 TUI 和 API,OpenCode 本体要按官网 https://opencode.ai/ 单独安装。
Q:vim.pack 和 lazy.nvim 要都配吗?
A:不需要,任选一种安装方式即可,README 把 vim.pack 列为推荐方式。
Q:按键与已有映射冲突怎么办?
A:<C-a>、<C-x>、go、goo 等只是 README 的推荐示例,可自行改成不冲突的按键。
Q:配置项有哪些?
A:README 只说明默认配置已足够可靠,完整选项与默认值需查看仓库内 lua/opencode/config.lua。
注意事项
- 插件可连接任意已有 OpenCode 服务,也可启动集成实例,连接细节见仓库配置类型说明。
- version = "*" 表示使用最新稳定版,需要尝鲜可自行调整。
- 修改按键映射或配置后需重启 Neovim 或重新加载配置才生效。
核心亮点
- 深度集成 Neovim,利用浮动窗口和缓冲区,交互体验流畅自然
- 支持流式输出和代码差异预览,实时查看 AI 生成结果
- 多会话管理,方便切换不同任务上下文
不足之处
- 依赖 OpenCode 命令行工具,需额外安装配置
- 文档/社区待观察
适用场景
- 在 Neovim 中编写代码时,需要快速获取 AI 建议或代码补全
- 进行代码审查或重构时,希望 AI 辅助分析并生成修改方案
- 学习新代码库或理解复杂逻辑时,通过对话式交互获取解释
替代项目
Copilot.nvim、ChatGPT.nvim、CodeCompanion.nvim
上一篇:CopilotForXcode
下一篇:SocratiCode
同类项目推荐
tastecode
开源
Windows 上统一管理多个 AI 编程代理的漂亮控制台
One desktop app for your coding agents, made for creative work. Early beta, Windows ···
gpt-pilot
开源
说需求,AI 帮你写代码并调试到能跑
The first real AI developer
ai-first-toolkit
开源
用 AI 技能包审计、重构、启动项目,让开发更智能
Open-source Claude Code skills and Codex skills for AI-first work. Audit, re-enginee···
PiG
开源
把 TypeScript 版 Pi 编码智能体原样搬进 Go,行为不变、部署更轻
PiG (Pi in Go) is a faithful Go port of upstream Pi, the TypeScript codebase behind ···
goverter
开源
声明接口签名,自动生成类型安全的 Go 结构体转换代码
Generate type-safe Go converters by defining function signatures.
cheat-sheets
开源
一页速查,搞定编程、游戏、AI开发常用知识
Cheat Sheets heaven for all kind of programming language and frameworks + Game and W···
nanolang
开源
让大模型少写代码也能跑起来的极简语言
A tiny experimental language designed to be targeted by coding LLMs
CodeAF
开源
用开放模型编排多智能体,自动完成编码任务
Open-Source Software factory for Open Models
ogcode
开源
省 token 的 AI 编码工作台,长会话成本直降 70%
An open-source, local-first AI teammate and agent operating environment for turning ···