必须升级编辑器至vim≥9.0或neovim≥0.9.0,安装curl和openssl,通过packer或手动方式安装插件,执行:fittenauth完成浏览器授权,:fittenstatus验证成功后重启,再在setup中启用enable_chat、enable_test_generation、enable_code_explanation及virtual_text选项。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在 Vim 或 Neovim 中启用 Fitten Code 的 AI 补全、问答、注释生成等核心能力,必须正确加载其官方插件并完成身份认证,否则所有功能均无法触发。
确认本地运行环境支持
确保你的 Vim 版本 ≥ 9.0 或 Neovim 版本 ≥ 0.9.0;低于此版本将无法加载 Fitten Code 插件的 Lua 模块,启动时会报 attempt to call a nil value 错误。
运行 :echo has('nvim-0.9') 或 :echo v:version >= 900 验证版本,不满足请先升级编辑器。
检查系统是否已安装 【curl】 和 【openssl】:Fitten Code 插件在首次认证时依赖二者发起 HTTPS 请求,缺一不可。Linux/macOS 用户可通过 which curl openssl 确认;Windows 用户需确保 Git Bash 或 WSL 中这两个命令可用。
安装插件(任选其一)
方法一:使用 Packer.nvim(推荐)
在 ~/.config/nvim/lua/plugins/fitten.lua 中添加:
use { 'fitten-code/vim-plugin', branch = 'main', config = function() require('fitten').setup() end }
保存后执行 :PackerSync → :qa! → 重启 Neovim。
方法二:手动安装(适用于无插件管理器场景)
执行:git clone https://gitcode.com/gh_mirrors/fi/vim-plugin.git ~/.vim/pack/fitten/start/vim-plugin
然后在 ~/.vimrc 或 ~/.config/nvim/init.vim 末尾追加:
packadd vim-plugin
lua require('fitten').setup()
注意:Neovim 用户若用 init.vim,必须确保该文件以 lua 命令结尾,否则 setup 不生效。
完成首次身份认证
第一步:打开任意代码文件,在普通模式下输入 :FittenAuth
第二步:终端将弹出浏览器窗口或显示授权 URL;【必须在该浏览器中完成登录并点击“允许”】,关闭窗口或跳过将导致 token 为空。
第三步:返回 Neovim,执行 :FittenStatus;若显示 status: authenticated 且有非空 user_id,说明认证成功。
第四步:重启 Neovim —— 这是强制要求,因为插件内部状态仅在初始化阶段读取 token,热重载无法刷新认证上下文。
启用关键功能开关
默认只开启基础补全,其余能力需显式启用:
在 require('fitten').setup({}) 的括号内加入以下配置项:
enable_chat = true,
enable_test_generation = true,
enable_code_explanation = true,
三项必须全部写入,漏掉任意一项都会导致对应功能按钮灰显或命令未定义。
虚拟文本(inline suggestion)默认关闭,如需开启,请额外添加:
virtual_text = { enabled = true, highlight_group = "FittenVirtualText" }
这行代码必须放在 setup() 内部,且不能与前面三项并列缩进错误——Lua 对齐敏感,多一个空格会导致解析失败。









