跳至内容

NvChad 界面

关于 mappings.lua 的几句话

在 NvChad 的官方文档中,会提到 <leader> 等命令,以及其他普通读者可能不理解的按键。原因是默认的 mappings.lua 文件 (../nvim/lua/core/mappings.lua)。

此文件及其描述的按键映射在此 概述。请注意,您可以使用自定义的 mappings.lua 文件 (../nvim/lua/custom/mappings.lua) 来覆盖任何按键映射。

为避免您正在阅读的文档中出现混淆,我们将假定您使用的是默认的 mappings.lua 文件,并将为您提供访问功能所需的实际命令。标准的按键引用是

  • Leader = 空格键
  • A = Alt
  • C = Ctrl
  • S = Shift

如果命令示例为 <leader>uu,我们将用实际的按键组合 空格uu 替换。

这将在下一节 使用 NvChad 中再次介绍。

安装 Neovim 并进入 NvChad 配置后,我们的 IDE 应该看起来像这样:

NvChad Default

该界面已经包含了一些高级功能,例如指示 git 仓库的状态,但可以通过使用语言服务器进一步增强,并通过覆盖一些基本配置来自定义。构成它的基本模块将在下面详细介绍。

Tabufline

Tabufline

用户界面提供了一个名为 Tabufline 的顶部栏,用于管理打开的缓冲区。只有在您打开一个以上文件时,Tabufline 才会显示。打开的缓冲区会显示文件类型图标、文件名及其状态。状态由一个图标指示。

如果像截图中的那样,我们有一个红色的 x,这意味着该文件可以关闭,因为它已经保存。如果图标是一个绿点 .,则表示文件需要保存,并且关闭命令 Shift + : + q 将会产生一个警告:“自上次更改以来未写入”。

右侧是用于设置深色浅色主题的图标。通过用鼠标单击它,我们可以选择想要的主题。

NvChad Light

在右侧,我们还有一个用于关闭编辑器的图标。

中间部分 - 打开的缓冲区

编辑器的中心部分由当前在编辑器中活动的缓冲区(index.en.md)组成。为了引入一些附加功能,我们可以同时在两个文件中工作,通过在示例中打开另一个文件(index.it.md)来实现分屏缓冲区。

在编辑器中,第一个缓冲区在前台显示,第二个在 Tabufline 中列出。现在,如果我们使用 Shift + : + vsplit 命令拆分第一个缓冲区,并选择右侧缓冲区,然后单击 Tabufline 中第二个文件名(index.it.md),它将在右侧缓冲区中打开,我们就可以并排处理这两个文件了。

NvChad Split

状态栏

Statusline

底部是状态栏,负责处理状态信息。右侧是编辑器状态。我们必须记住,我们使用的是文本编辑器,特别是它保持着 Vim 的理念和操作。可能的状态是:

  • 正常模式
  • 插入模式
  • 命令模式
  • 可视化模式

编辑文档从正常模式开始,在该模式下打开文件,然后可以切换到插入模式进行编辑,完成后按 Esc 退出并返回正常模式

现在要保存文件,需要切换到命令模式,在状态栏中输入 :,然后输入 wwrite)进行写入,再按 Esc 返回正常模式。状态指示在学习如何使用它时非常有用,特别是对于不熟悉 Vim 工作流程的用户。

然后我们找到打开的文件名,如果我们正在处理一个 git 仓库,我们将看到仓库状态的指示。这要归功于 lewis6991/gitsigns.nvim 插件。

转向右侧,我们找到打开编辑器的文件夹名称。在使用 LSP 时,这表示被视为 工作区 的文件夹,因此在诊断过程中进行评估,并跟踪文件内光标的位置。

集成帮助

NvChad 和 Neovim 提供了一些有用的命令来显示预设的按键组合和可用选项。

如果单独按下 空格 键,将提供一个相关命令的图例,如下面的截图所示:

Space Key

要查看编辑器中包含的所有命令,我们可以使用 空格 + wK 命令,这将产生以下结果:

leader wK

d 键可以显示剩余的命令:

leader wK d

如我们所见,几乎所有的命令都涉及文档或缓冲区内的导航。不包含用于打开文件的命令。这些命令由 Neovim 提供。

要查看 Neovim 的所有选项,可以使用 Shift + : + options 命令,这将呈现一个按类别索引的选项树。

Nvim Options

这样,通过内置帮助,我们就可以在编辑器的使用过程中学习命令,还可以深入了解可用的选项。

NvimTree

为了处理我们的文件,我们需要一个文件浏览器,这由 kyazdani42/nvim-tree.lua 插件提供。使用 Ctrl + n 组合键可以打开 NvimTree。

NvimTree

关于 NvimTree 命令和功能的详细描述可以在 专用页面 上找到。

现在我们已经探索了界面组件,可以继续使用 NvChad 了。

作者:Franco Colussi

贡献者:Steven Spencer, Ganna Zhyrnova