# nvim

**Repository Path**: LitchiXian/nvim

## Basic Information

- **Project Name**: nvim
- **Description**: neovim 的配置文件
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-12
- **Last Updated**: 2026-07-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Neovim 配置说明

> 适用于 **Neovim ≥ 0.12** 的现代化配置，支持 Rust / Web 等开发场景。  
> 功能涵盖：文件树、主题切换、模糊搜索、LSP 支持、代码补全、语法高亮等。

---

## 前置依赖

| 依赖 | 用途 | 安装方式 |
|------|------|----------|
| [Neovim](https://github.com/neovim/neovim/releases) ≥ 0.12 | 编辑器本体 | 见官方文档 |
| [tree-sitter-cli](https://github.com/tree-sitter/tree-sitter) ≥ 0.26 | 语法高亮解析器编译 | `sudo npm install -g tree-sitter-cli` |
| C 编译器 (gcc/clang) | 编译 treesitter 解析器 | `sudo apt install build-essential` |
| [ripgrep](https://github.com/BurntSausage/ripgrep) | Telescope 全文搜索 | `sudo apt install ripgrep` |
| [rust-analyzer](https://rust-analyzer.github.io/) | Rust LSP（由 rustaceanvim 调用） | `rustup component add rust-analyzer` |
| Node.js + npm | 部分工具安装依赖 | `sudo apt install nodejs npm` |

### 可选依赖

| 依赖 | 用途 | 安装方式 |
|------|------|----------|
| [mpv](https://mpv.io/) | Neovim 内播放/控制音乐 | `sudo apt install mpv` |
| [playerctl](https://github.com/altdesktop/playerctl) | 控制外部播放器（Spotify 等） | `sudo apt install playerctl` |

## 安装步骤

### 1. 安装前置依赖
```bash
# Ubuntu / Debian
sudo apt install build-essential ripgrep nodejs npm
sudo npm install -g tree-sitter-cli
rustup component add rust-analyzer
```

### 2. 克隆配置仓库
```bash
git clone https://gitee.com/LitchiXian/nvim.git ~/.config/nvim
```

### 3. 启动 Neovim 并安装插件
```bash
nvim
:PackerSync
```
首次启动会自动安装所有插件（需联网）。  
Packer 安装完成后**重启 Neovim**，treesitter 解析器会自动编译安装。