Neovim
Neovim[1] is a highly extensible and open source text editor that aims to improve upon and modernize the popular Vim[2] editor. It's designed to be a drop-in replacement for Vim, maintaining compatibility with most Vim plugins and configurations while offering additional features and improvements. Neovim focuses on extensibility, usability, and performance.
It introduces a powerful plugin architecture that allows for asynchronous plugin execution, which can significantly improve performance for certain operations. It also includes a built-in terminal emulator, allowing users to run shell commands directly within the editor. The project emphasizes code quality and maintainability, with a clean, well-documented codebase that makes it easier for developers to contribute.
インストール
nix-shellを使う
nix-shell -p neovim
グローバル設定を使う
environment.systemPackages = [
pkgs.neovim
];
設定を変更したら、次のコマンドを実行して変更を適用する:
sudo nixos-rebuild switch
Home設定を使う
home.packages = [
pkgs.neovim
];
After updating your configuration, apply the changes by running:
home-manager switch
設定
Basic
<div lang="en" dir="ltr" class="mw-content-ltr">
# Global Configuration
</div>
programs.neovim = {
enable = true;
defaultEditor = true;
};
<div lang="en" dir="ltr" class="mw-content-ltr">
# Home Configuration
</div>
programs.neovim = {
enable = true;
extraConfig = ''
set number relativenumber
'';
};
Advanced
<div lang="en" dir="ltr" class="mw-content-ltr">
# Global Configuration
</div>
programs.neovim = {
enable = true;
defaultEditor = true;
viAlias = true;
vimAlias = true;
configure = {
customRC = ''
set number
set cc=80
set list
set listchars=tab:→\ ,space:·,nbsp:␣,trail:•,eol:¶,precedes:«,extends:»
if &diff
colorscheme blue
endif
'';
packages.myVimPackage = with pkgs.vimPlugins; {
start = [ ctrlp ];
};
};
};
<div lang="en" dir="ltr" class="mw-content-ltr">
# Home Configuration
# You have to add the line below to set it as the default editor:
</div>
environment.variables.EDITOR = "nvim";
Tips and Tricks
Location of Options
The home manager options are defined in the following Home Manager Options Manual[3].
Package Variations
Have a look at the Neovim Nightly Overlay[5] to install the most recent current nightly version of Neovim.
You can run the master version via the following command:
nix run "github:nix-community/neovim-nightly-overlay"
Plugin Management
plugins = [
<div lang="en" dir="ltr" class="mw-content-ltr">
# Example Plugin: nvim-tree-lua
</div>
pkgs.vimPlugins.nvim-tree-lua
<div lang="en" dir="ltr" class="mw-content-ltr">
# Example Plugin: vim-startify with configuration
</div>
{
plugin = pkgs.vimPlugins.vim-startify;
config = "let g:startify_change_to_vcs_root = 0";
}
<div lang="en" dir="ltr" class="mw-content-ltr">
# Example Plugin: nvim-colorizer-lua with Lua config
# Due to how the runtimepath for Lua modules is processed, your configuration may require
# packadd! plugin-name to require a module. A home-manager example:
</div>
{
plugin = pkgs.vimPlugins.nvim-colorizer-lua;
config = ''
packadd! nvim-colorizer.lua
lua << END
require 'colorizer'.setup {
'*'; <span lang="en" dir="ltr" class="mw-content-ltr">-- Highlight all files, but customize some others.</span>
'!vim'; <span lang="en" dir="ltr" class="mw-content-ltr">-- Exclude vim from highlighting.</span>
}
END
'';
}
<div lang="en" dir="ltr" class="mw-content-ltr">
# Example Plugin: nvim-treesitter with Lua config
</div>
{
plugin = pkgs.vimPlugins.nvim-treesitter;
config = ''
packadd! nvim-treesitter
lua <<EOF
require'nvim-treesitter.configs'.setup {
highlight = {
enable = true, <span lang="en" dir="ltr" class="mw-content-ltr">-- false will disable the whole extension</span>
disable = {}, <span lang="en" dir="ltr" class="mw-content-ltr">-- list of languages that will be disabled</span>
},
incremental_selection = {
enable = true,
keymaps = {
init_selection = "gnn",
node_incremental = "grn",
scope_incremental = "grc",
node_decremental = "grm",
},
},
textobjects = {
select = {
enable = true,
lookahead = true,
keymaps = {
["af"] = "@function.outer",
["if"] = "@function.inner",
["ac"] = "@class.outer",
["ic"] = "@class.inner",
},
},
},
}
EOF
'';
}
<div lang="en" dir="ltr" class="mw-content-ltr">
# Installing grammars for tree-sitter
# Option 1: Install all grammar packages
pkgs.vimPlugins.nvim-treesitter.withAllGrammars
# Option 2: Install specific grammar packages
# (pkgs.vimPlugins.nvim-treesitter.withPlugins (p: [ p.c p.java ]))
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
# Option 3: Installing grammars without Nix
# Installing grammar packages through the built-in command can lead to errors.
# The following Neovim command will install syntax highlighting for the C programming language: :TSInstall c
</div>
];
Frameworks
If you prefer not to configure your system manually, NixOS offers several predefined configurations and community-supported options. Here are a few of them:
Another excellent option is LunarVim[9]. The development community describes it as "an IDE layer for Neovim with sane defaults." LunarVim includes an installer/updater for LSP modules and other features. It can be installed via the lunarvim
package from nixpkgs
and is started with the lvim
command.
The configuration for LunarVim is stored in ./config/lvim
.
トラブルシューティング
参照
- ↑ Neovim Team, "Home - Neovim", Neovim Official Website, N/A. https://neovim.io/
- ↑ NixOS Wiki, Vim. https://wiki.nixos.org/wiki/Vim
- ↑ Nix Community, "Home Manager Option Search", Nix Community GitHub Pages, N/A. https://nix-community.github.io/home-manager/options.xhtml#opt-programs.neovim.enable
- ↑ MyNixOS Team, "Search: nixpkgs/option/programs.neovim", MyNixOS, N/A. https://mynixos.com/search?q=nixpkgs%2Foption%2Fprograms.neovim
- ↑ Nix Community, "neovim-nightly-overlay", GitHub, N/A. https://github.com/nix-community/neovim-nightly-overlay
- ↑ LazyVim Team, "LazyVim", LazyVim Official Website, N/A. https://www.lazyvim.org/
- ↑ AstroNvim Team, "AstroNvim", AstroNvim Official Website, N/A. https://astronvim.com/
- ↑ NvChad Team, "NvChad", NvChad Official Website, N/A. https://nvchad.com/
- ↑ LunarVim Team, "Installation", LunarVim Documentation, N/A. https://www.lunarvim.org/docs/installation