# nvim_lua

**Repository Path**: stesen/nvim_lua

## Basic Information

- **Project Name**: nvim_lua
- **Description**: No description available
- **Primary Language**: Lua
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-04-23
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Neovim Lua 配置

基于 [Neovim-from-scratch](https://github.com/LunarVim/Neovim-from-scratch.git) 改进的现代化 Neovim 配置，使用 lazy.nvim 作为插件管理器。

## 环境要求

- **Neovim >= 0.8.0** (建议 0.9.0+)
- **Git >= 2.19.0** (for partial clones support)
- **C 编译器** (gcc/clang，用于编译 tree-sitter 解析器)
- **Python 3** (可选，用于 Python 支持)
- **Node.js** (可选，用于 LSP 支持)

---

## 快速开始

### 1. 备份现有配置

```bash
# 备份原有配置
mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak
mv ~/.local/state/nvim ~/.local/state/nvim.bak
mv ~/.cache/nvim ~/.cache/nvim.bak
```

### 2. 克隆配置

```bash
git clone https://github.com/stesen/nvim_lua ~/.config/nvim
```

### 3. 安装系统依赖

#### Ubuntu / Debian

```bash
# 更新软件源
sudo apt update

# 安装 Neovim (推荐从官方源或自行编译安装最新版)
sudo apt install neovim

# 或安装最新版 (Ubuntu 22.04+)
sudo apt install neovim python3-neovim

# 基础工具
sudo apt install git curl wget unzip

# 剪贴板支持
sudo apt install xclip xsel

# 搜索工具 (Telescope 必备)
sudo apt install ripgrep fd-find

# 编译工具 (tree-sitter 需要)
sudo apt install build-essential

# 可选: LazyGit
sudo add-apt-repository ppa:lazygit-team/release
sudo apt update
sudo apt install lazygit

# 可选: Nerd Font (Meslo)
wget https://github.com/ryanoasis/nerd-fonts/releases/download/v3.1.1/Meslo.zip
mkdir -p ~/.local/share/fonts
unzip Meslo.zip -d ~/.local/share/fonts/
fc-cache -fv
```

#### Arch Linux

```bash
# 基础依赖
sudo pacman -S neovim git curl wget unzip

# 剪贴板支持
sudo pacman -S xclip xsel

# 搜索工具
sudo pacman -S ripgrep fd

# 编译工具
sudo pacman -S base-devel

# 可选: LazyGit
sudo pacman -S lazygit

# 可选: Nerd Font
sudo pacman -S ttf-meslo-nerd
# 或从 AUR 安装更多字体
yay -S ttf-jetbrains-mono-nerd
```

#### macOS

```bash
# 安装 Homebrew (如果未安装)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Neovim 及依赖
brew install neovim git curl wget

# 剪贴板 (macOS 自带 pbcopy/pbpaste，无需额外安装)

# 搜索工具
brew install ripgrep fd

# 可选: LazyGit
brew install lazygit

# 可选: Nerd Font
brew tap homebrew/cask-fonts
brew install --cask font-meslo-lg-nerd-font
```

---

## Python 与 Node 支持

### Python 支持

```bash
# 安装 pynvim
pip3 install pynvim

# 或指定 Python 版本
python3 -m pip install pynvim
```

### Node.js 支持

```bash
# 安装 neovim Node 客户端
npm install -g neovim

# 或使用 yarn
yarn global add neovim
```

---

## 首次启动

```bash
nvim
```

首次启动时，lazy.nvim 会自动：
1. 下载并安装自身
2. 安装所有配置的插件
3. 编译 tree-sitter 解析器

**注意**: 第一次启动可能需要几分钟时间，请耐心等待。

---

## 快捷键速查

### 基础操作

| 快捷键 | 功能 |
|--------|------|
| `<Space>` | Leader 键 |
| `<F4>` | 打开/关闭文件树 |
| `<Ctrl-n>` | 打开文件树 |
| `<Ctrl-t>` | 打开浮动终端 |

### 文件操作 (Telescope)

| 快捷键 | 功能 |
|--------|------|
| `<leader>ff` | 查找文件 |
| `<leader>fg` | 全局搜索 (Live Grep) |
| `<leader>fb` | 查找缓冲区 |
| `<leader>fh` | 查找帮助 |
| `<leader>fr` | 查找最近文件 |

### LSP 相关

| 快捷键 | 功能 |
|--------|------|
| `gd` | 跳转到定义 |
| `gr` | 查找引用 |
| `K` | 显示文档 |
| `<leader>rn` | 重命名 |
| `<leader>ca` | 代码操作 |
| `<leader>f` | 格式化代码 |

### Git 操作

| 快捷键 | 功能 |
|--------|------|
| `<leader>gg` | 打开 LazyGit |
| `<leader>gs` | Git 状态 |
| `]g` / `[g` | 下一个/上一个 hunk |

---

## 插件管理

使用 lazy.nvim 管理插件：

```vim
:Lazy        " 打开插件管理器
:Lazy sync   " 同步插件
:Lazy update " 更新所有插件
:Lazy clean  " 清理未使用的插件
```

---

## 健康检查

```vim
:checkhealth
```

检查以下内容：
- Python 3 支持
- Node.js 支持
- 剪贴板支持
- Tree-sitter 解析器

---

## 目录结构

```
~/.config/nvim/
├── init.lua                 # 入口文件
├── lua/
│   ├── plugins/             # lazy.nvim 插件配置
│   │   ├── core.lua         # 核心依赖
│   │   ├── ui.lua           # 界面插件
│   │   ├── editor.lua       # 编辑器增强
│   │   ├── lsp.lua          # LSP 配置
│   │   ├── cmp.lua          # 补全引擎
│   │   ├── telescope.lua    # 搜索插件
│   │   ├── treesitter.lua   # 语法高亮
│   │   ├── git.lua          # Git 集成
│   │   └── misc.lua         # 其他工具
│   └── user/                # 核心用户配置
│       ├── options.lua      # 选项设置
│       ├── keymaps.lua      # 键位映射
│       ├── autocommands.lua # 自动命令
│       ├── colorscheme.lua  # 主题配置
│       ├── mobile.lua       # 移动端适配
│       ├── profiler.lua     # 性能分析
│       └── touch.lua        # 触摸支持
└── plugin/                  # 自动生成目录
```

---

## 故障排除

### 启动时出现错误

1. **删除缓存重新安装**:
   ```bash
   rm -rf ~/.cache/nvim
   rm -rf ~/.local/share/nvim/lazy
   nvim
   ```

2. **检查 Neovim 版本**:
   ```bash
   nvim --version  # 需要 >= 0.8.0
   ```

### 字体显示异常

确保终端已配置使用 Nerd Font (如 MesloLGM Nerd Font)。

### 某些语言无语法高亮

在 Neovim 中运行：
```vim
:TSInstall <language>   " 安装指定语言解析器
:TSInstallInfo          " 查看已安装解析器
```

---

## 许可证

MIT License