Official NixOS Wiki

Neovim: Difference between revisions

← Older edit
Kaarelkivisalu (talk | contribs)
1 edit
VisualWikitext
Duob (talk | contribs)
2 edits
Marked this version for translation
m Fix neovim command
 
(22 intermediate revisions by 11 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{infobox application
  |name=Neovim
  |image=Neovim-mark.svg
  |type=Text Editor
  |developer=Neovim Core Team & Community
  |firstRelease=November 1, 2015
  |latestRelease=Nvim 0.11.2 (May 30, 2025)
  |status=Active
  |license=[https://www.apache.org/licenses/LICENSE-2.0 Apache 2.0] (with parts under Vim license)
  |os=Cross-platform (Linux, macOS, Windows)
  |platform=Desktop
  |programmingLanguage=C, Lua, Vim Script
  |website=[https://neovim.io/ neovim.io]
  |github=neovim/neovim
  |bugTracker=[https://github.com/neovim/neovim/issues GitHub Issues]
  |documentation=[https://neovim.io/doc/ Official Documentation]
}}
<translate>
<translate>
<!--T:1-->
<!--T:1-->
[https://neovim.io/ Neovim] is a highly extensible and open source text editor that aims to improve upon and modernize the popular [[Vim]] 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.
:''See also: [[Vim]]''
[https://neovim.io/ Neovim]<ref>Neovim Team, "Home - Neovim", Neovim Official Website, Last updated March 2025, Accessed June 2025. https://neovim.io/</ref> is a highly extensible and open source text editor that aims to improve upon and modernize the popular [[Vim]]<ref>NixOS Wiki Community, "Vim", NixOS Wiki, Last edited 24 February 2025, Accessed June 2025. https://wiki.nixos.org/wiki/Vim</ref> 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.


<!--T:2-->
<!--T:2-->
Line 9: Line 28:
== Installation == <!--T:3-->
== Installation == <!--T:3-->


<!--T:4-->
==== Shell ==== <!--T:4-->
==== Using nix-shell ====
 
<syntaxhighlight lang="bash" start="3">
<!--T:60-->
nix-shell -p neovim
To temporarily use Neovim in a shell environment without modifying your system configuration, you can run:
</syntaxhighlight>
</translate>
 
{{code|lang=bash|line=no|1=$ nix-shell -p neovim}}
 
<translate>
<!--T:61-->
This makes the Neovim editor available in your current shell. You can then launch Neovim by typing <code>nvim</code>.
 
==== System setup ==== <!--T:62-->


<!--T:5-->
<!--T:63-->
==== Using Global Configuration ====
To install Neovim system-wide, making it available to all users, add the following to your configuration:
<syntaxhighlight lang="text">
</translate>
 
{{code|lang=nix|line=no|1=<translate><!--T:64--> # Example for /etc/nixos/configuration.nix</translate>
environment.systemPackages = [
environment.systemPackages = [
  pkgs.neovim
  pkgs.neovim
];
];
</syntaxhighlight>After modifying your configuration, apply the changes by running:<syntaxhighlight lang="bash">
sudo nixos-rebuild switch
</syntaxhighlight>


<!--T:6-->
<translate><!--T:65--> # User-specific installation (in ~/.config/nixpkgs/home.nix)</translate>
==== Using Home Configuration ====
home.packages = [
<syntaxhighlight lang="text">
   pkgs.neovim
home.packages = [  
];}}
   pkgs.neovim  
 
];
<translate>
</syntaxhighlight>After updating your configuration, apply the changes by running:<syntaxhighlight lang="bash">
<!--T:66-->
home-manager switch
After rebuilding your system with <code>nixos-rebuild switch</code> or <code>home-manager switch</code>, Neovim will be installed and accessible.
</syntaxhighlight>


== Configuration == <!--T:7-->
== Configuration == <!--T:7-->


<!--T:8-->
==== Basic ==== <!--T:8-->
==== Basic ====
</translate>
<syntaxhighlight lang="nix">
 
{{code|lang=nix|line=no|1=<translate>
<!--T:39-->
# Global Configuration
# Global Configuration
</translate>
programs.neovim = {
programs.neovim = {
   enable = true;
   enable = true;
Line 46: Line 74:
};
};


<!--T:9-->
<translate>
<!--T:40-->
# Home Configuration
# Home Configuration
</translate>
programs.neovim = {
programs.neovim = {
   enable = true;
   enable = true;
Line 53: Line 83:
     set number relativenumber
     set number relativenumber
   '';
   '';
};
};}}
</syntaxhighlight>
 
<translate>
==== Advanced ==== <!--T:10-->
</translate>


<!--T:10-->
{{code|lang=nix|line=no|1=<translate>
==== Advanced ====
<!--T:41-->
<syntaxhighlight lang="nix">
# Global Configuration
# Global Configuration
</translate>
programs.neovim = {
programs.neovim = {
   enable = true;
   enable = true;
Line 81: Line 114:
};
};


<!--T:11-->
<translate>
<!--T:42-->
# Home Configuration
# Home Configuration
# You have to add the line below to set it as the default editor:
# You have to add the line below to set it as the default editor:
environment.variables.EDITOR = "nvim";
</translate>
</syntaxhighlight>
environment.variables.EDITOR = "nvim";}}


== Tips and Tricks == <!--T:12-->
<translate>
 
<!--T:12-->
<!--T:13-->
== Tips and Tricks ==
==== Location of Options ====
{{expand}}
The home manager options are defined in the following [https://nix-community.github.io/home-manager/options.xhtml#opt-programs.neovim.enable Home Manager Options Manual].


<!--T:14-->
==== Package Variations ==== <!--T:15-->
The global options are listed on [https://mynixos.com/search?q=nixpkgs%2Foption%2Fprograms.neovim MyNixOS].


<!--T:15-->
<!--T:44-->
==== Neovim Nightly ====
Have a look at the [https://github.com/nix-community/neovim-nightly-overlay Neovim Nightly Overlay]<ref>Nix Community, "neovim-nightly-overlay", GitHub, Last updated June 2025, Accessed June 2025. https://github.com/nix-community/neovim-nightly-overlay</ref> to install the most recent current nightly version of Neovim.
Have a look at the [https://github.com/nix-community/neovim-nightly-overlay Neovim Nightly Overlay] to install the most recent current nightly version of Neovim.


<!--T:16-->
<!--T:16-->
You can run the master version via the following command:
You can run the master version via the following command:
</translate>


<!--T:17-->
{{code|lang=bash|line=no|1=$ nix run "github:nix-community/neovim-nightly-overlay"}}
nix run "github:nix-community/neovim-nightly-overlay"


<!--T:18-->
<translate>
==== Pre-Configured Configurations ====
==== Plugin Management ==== <!--T:21-->
If you prefer not to configure your system manually, NixOS offers several predefined configurations and community-supported options. Here are a few of them:  
</translate>


<!--T:19-->
{{code|lang=nix|line=no|1=plugins = [
* [https://www.lazyvim.org/ LazyVim]
<translate>
* [https://astronvim.com/ AstroVim]
  <!--T:49-->
* [https://nvchad.com/ NVChad]
# Example Plugin: nvim-tree-lua
Another excellent option is [https://www.lunarvim.org/docs/installation LunarVim]. 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 <code>lunarvim</code> package from <code>nixpkgs</code> and is started with the <code>lvim</code> command.
</translate>
 
<!--T:20-->
The configuration for LunarVim is stored in <code>./config/lvim</code>.
 
<!--T:21-->
==== Plugin Management ====
<syntaxhighlight lang="nix">
plugins = [
  # Example Plugin: nvim-tree-lua
   pkgs.vimPlugins.nvim-tree-lua
   pkgs.vimPlugins.nvim-tree-lua


   <!--T:22-->
<translate>
   <!--T:50-->
# Example Plugin: vim-startify with configuration
# Example Plugin: vim-startify with configuration
</translate>
   {
   {
     plugin = pkgs.vimPlugins.vim-startify;
     plugin = pkgs.vimPlugins.vim-startify;
Line 133: Line 157:
   }
   }


   <!--T:23-->
<translate>
   <!--T:51-->
# Example Plugin: nvim-colorizer-lua with Lua config
# Example Plugin: nvim-colorizer-lua with Lua config
   # Due to how the runtimepath for Lua modules is processed, your configuration may require  
   # 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:
   # packadd! plugin-name to require a module. A home-manager example:
</translate>
   {
   {
     plugin = pkgs.vimPlugins.nvim-colorizer-lua;
     plugin = pkgs.vimPlugins.nvim-colorizer-lua;
Line 143: Line 169:
       lua << END
       lua << END
         require 'colorizer'.setup {
         require 'colorizer'.setup {
           '*'; -- Highlight all files, but customize some others.
           '*';<translate> <!--T:52--> -- Highlight all files, but customize some others.</translate>
           '!vim'; -- Exclude vim from highlighting.
           '!vim';<translate> <!--T:53--> -- Exclude vim from highlighting.</translate>
         }
         }
       END
       END
Line 150: Line 176:
   }
   }


   <!--T:24-->
<translate>
   <!--T:54-->
# Example Plugin: nvim-treesitter with Lua config
# Example Plugin: nvim-treesitter with Lua config
</translate>
   {
   {
     plugin = pkgs.vimPlugins.nvim-treesitter;
     plugin = pkgs.vimPlugins.nvim-treesitter;
Line 159: Line 187:
         require'nvim-treesitter.configs'.setup {
         require'nvim-treesitter.configs'.setup {
           highlight = {
           highlight = {
             enable = true,              -- false will disable the whole extension
             enable = true,              <translate><!--T:55--> -- false will disable the whole extension</translate>
             disable = {},              -- list of languages that will be disabled
             disable = {},              <translate><!--T:56--> -- list of languages that will be disabled</translate>
           },
           },
           incremental_selection = {
           incremental_selection = {
Line 188: Line 216:
   }
   }


   <!--T:25-->
<translate>
   <!--T:57-->
# Installing grammars for tree-sitter
# Installing grammars for tree-sitter
   # Option 1: Install all grammar packages
   # Option 1: Install all grammar packages
Line 196: Line 225:
   # (pkgs.vimPlugins.nvim-treesitter.withPlugins (p: [ p.c p.java ]))
   # (pkgs.vimPlugins.nvim-treesitter.withPlugins (p: [ p.c p.java ]))


   <!--T:26-->
   <!--T:58-->
# Option 3: Installing grammars without Nix
# Option 3: Installing grammars without Nix
   # Installing grammar packages through the built-in command can lead to errors.  
   # 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
   # The following Neovim command will install syntax highlighting for the C programming language: :TSInstall c
];
</translate>
</syntaxhighlight>
];}}
 
<translate>
==== Frameworks ==== <!--T:18-->
 
<!--T:45-->
If you prefer not to configure your system manually, NixOS offers several predefined configurations and community-supported options. Here are a few of them:
 
<!--T:19-->
* [https://www.lazyvim.org/ LazyVim]<ref>LazyVim Team, "Getting Started", LazyVim Official Website, © 2025, Accessed June 2025. https://www.lazyvim.org/</ref>
 
<!--T:46-->
* [https://astronvim.com/ AstroNvim]<ref>AstroNvim Team, "AstroNvim", AstroNvim Official Website, N/A, Accessed June 2025. https://astronvim.com/</ref>
 
<!--T:47-->
* [https://nvchad.com/ NVChad]<ref>Siduck, "NvChad", NvChad Official Website, © 2025, Accessed June 2025. https://nvchad.com/</ref>
LazyVim, by default, will prevent loading plugins that are not managed by LazyVim. This includes all plugins installed via Nix. If you want to install plugins with both Nix and LazyVim, add the following to your LazyVim setup:
 
</translate>
require("lazy").setup(lazyPackages, {
  performance = {
    reset_packpath = false, -- so that plugins outside of lazy can be loaded
  },
})
vim.cmd([[ packloadall]] ) -- load plugins outside of lazy
 
<translate>
[https://github.com/folke/lazy.nvim/issues/402#issuecomment-2084997594 Source]
 
==== FHS wrapper ==== <!--T:67-->
 
<!--T:68-->
You can create a custom neovim FHS wrapper
</translate>
 
{{code|lang=nix|line=no|1=
{
  buildFHSEnv,
  writeShellScript,
  neovim,
}:
buildFHSEnv {
  name = "nvim-fhs";
  targetPkgs = pkgs: [ neovim ];
 
  runScript = writeShellScript "nvim-fhs.sh" ''
    exec ${neovim}/bin/nvim "$@"
  '';
}
}}
 
<!--T:FHS_WRAPPER_SOURCE-->
<translate>
<!--T:69-->
This FHS wrapper example is based on a contribution to nixpkgs<ref name="nixpkgs-pr-334032">NixOS, "Feature: Custom Neovim FHS Wrapper" (Pull Request #334032), GitHub, 2025, Accessed June 2025. https://github.com/NixOS/nixpkgs/pull/334032</ref>.
For an extended configuration that includes setting up `mason.nvim` with a similar FHS environment, see this [https://github.com/NixOS/nixpkgs/issues/281219#issuecomment-2284713258 NixOS/nixpkgs issue comment].


== References == <!--T:27-->
<!--T:59-->
== Troubleshooting ==
{{expand}}


<!--T:28-->
==== lua-language-server: Dynamically linked executable error ==== <!--T:70-->
# https://neovim.io/
# https://github.com/neovim/neovim
# https://nix-community.github.io/home-manager/options.xhtml#opt-programs.neovim.enable
# https://mynixos.com/search?q=nixpkgs%2Foption%2Fprograms.neovim
# https://github.com/m15a/flake-awesome-neovim-plugins
# https://github.com/NixNeovim/NixNeovimPlugins
# https://www.lazyvim.org/
# https://astronvim.com/
# https://nvchad.com/


<!--T:71-->
In your <code>~/.local/state/nvim/lsp.log</code>, you have the following error:
</translate>
</translate>
{{code|lang=text|line=no|1=[ERROR][2025-06-07 23:13:15] ...p/_transport.lua:36 "rpc" "lua-language-server" "stderr" "Could not start dynamically linked executable: /home/incogshift/.local/share/nvim/mason/packages/lua-language-server/libexec/bin/lua-language-server\nNixOS cannot run dynamically linked executables intended for generic\nlinux environments out of the box. For more information, see:\nhttps://nix.dev/permalink/stub-ld\n"}}
<!--T:LUA_LS_SO_REF-->
<translate>
<!--T:72-->
A solution for this issue can be found on Stack Overflow<ref name="so-lua-ls-dynlink">Stack Overflow Contributor, "Answer to 'Could not start dynamically linked executable... on NixOS'", Stack Overflow, 2025, Accessed June 2025. https://stackoverflow.com/a/78215911/27134695</ref>.
== See also == <!--T:73-->
<!--T:74-->
* [[Home Manager]] – For declarative Neovim configuration at the user level: [https://nix-community.github.io/home-manager/options.html#opt-programs.neovim.enable Neovim module in Home Manager]
* [https://neovim.io/doc/ Official Documentation] – Official Neovim documentation.
* [https://search.nixos.org/options?channel=unstable&query=programs.neovim NixOS options for Neovim] – System-level Neovim configuration.
* [https://discourse.nixos.org/search?q=neovim Neovim discussions on NixOS Discourse] – Community tips, troubleshooting, and use cases.
* [https://github.com/nix-community/neovim-overlay Neovim Overlay on Nixpkgs] – For nightly builds and additional Neovim packages.
== References == <!--T:27-->
<!--T:75-->
[[Category:Applications]]
[[Category:Applications]]
 
[[Category:CLI Applications]]
[[Category:Text Editor]]
[[Category:Text Editor]]
</translate>
Retrieved from "https://wiki.nixos.org/wiki/Neovim"