homebrew-neovim
Homebrew formula for Neovim.
Install
To install the latest stable release from homebrew core:
brew install neovim
To upgrade:
brew update
brew upgrade neovim
To install the latest, potentially unstable, development version of Neovim:
brew install --HEAD neovim
Use
The program name is nvim
(not neovim
).
nvim
In nvim, run :CheckHealth
. It checks for common problems and best practices.
Report
If you run into problems, follow the Troubleshooting section below before filing an issue. If you still have problems:
-
Search the issue tracker for your problem. GitHub does not show closed issues by default, but it will search them. Many issues have been resolved already.
-
Include the link to the result of your
brew gist-logs neovim
command. We cannot debug issues without detailed information about the failure. -
It helps to capture the verbose (
-v
) install output. For example,brew install neovim
would becomebrew install -v neovim
. Paste the output in your bug report, and make sure to wrap it with a "fence" so it renders correctly:``` # output goes here ```
Troubleshoot
- Run
brew update
then try again. - Run
brew doctor
to diagnose common issues. - Check that Command Line Tools for Xcode (CLT) and/or Xcode are up to
date by checking for updates in the App Store.
- If the build fails with
fatal error: '__debug' file not found
, you have to install Xcode. This is due to a bug in the Xcode CLT 6.3. - If the build fails with
ld: library not found for -lgcc_s
, make sure you have the same version of Xcode and Xcode CLT installed.
- If the build fails with
- Check the Homebrew Troubleshooting page. In particular, the Check for common issues section.
- You can create a gist log with
brew gist-logs neovim
. - Use
--verbose
to get the verbose output, i.e.brew install --HEAD --verbose neovim
. - Use
--debug
to be in the debug mode. In the debug mode, when failing, you can go into the interactive shell to check the building files before homebrew neutralizing them. - If you encounter the error
CMAKE_USE_SYSTEM_CURL is ON but a curl is not found
, then you're missing the dependency for cURL that allows downloads over TLS. Refer to your operating system's section in Linuxbrew Dependencies to fix this.