要在neovim中安装并启用bubbly状态栏插件,须先确认已安装packer.nvim;再在插件配置中添加use语句,运行:packercompile与:packersync;最后通过require('bubbly').setup()配置并重启neovim生效。

要在Neovim中安装并启用Bubbly状态栏插件,必须先确认已安装packer.nvim包管理器,否则后续配置无法加载。
安装Bubbly.nvim插件
打开Neovim,执行:PackerSync确保packer已就绪;若未安装packer,请先按官方方式配置完毕再继续。
在~/.config/nvim/lua/plugins/bubbly.lua(或你惯用的插件配置文件)中添加以下代码:
use { 'datwaft/bubbly.nvim', config = function() require('bubbly').setup() end }
保存后,在Neovim中运行:PackerCompile→:PackerSync,等待插件下载并编译完成。
基础配置与启用
新建或编辑~/.config/nvim/lua/config/bubbly.lua,写入最小可用配置:
require('bubbly').setup({ statusline = { 'mode', 'truncate', 'path', 'branch', 'filetype' } })
然后在init.lua顶部附近(建议在插件加载之后、其他UI设置之前)加入:require('config.bubbly')。
【必须重启Neovim或执行:source $MYVIMRC才能让状态栏生效】。仅重载Lua模块不会触发statusline刷新。
自定义状态栏内容顺序
状态栏模块顺序直接影响显示逻辑——比如把'progress'放在'truncate'前面会导致路径截断失效,因为progress依赖当前buffer宽度计算,而truncate需优先占据空间。
推荐按此逻辑排序:模式→路径截断→文件路径→分支→Git变更→语言服务器诊断→分隔符→文件类型→进度条。
对应配置片段为:
statusline = { 'mode', 'truncate', 'path', 'branch', 'signify', 'coc', 'divisor', 'filetype', 'progress' }
切换配色方案
方法一:直接覆盖默认调色板
在setup()参数中传入palette表,例如深色背景常用组合:
palette = { background = '#1e1e1e', foreground = '#d4d4d4', blue = '#569cd6', green = '#608b4e' }
方法二:复用已有的主题变量(需提前定义)
若你已在config/colors.lua中声明my_colors表,可直接引用:palette = my_colors。
注意:修改palette后必须重新运行:PackerSync或重启Neovim,热重载不生效。











