# 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-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Neovim Lua 配置

个人 Neovim 配置，使用 [lazy.nvim](https://github.com/folke/lazy.nvim) 管理插件，基于 Lua 构建。

---

## 环境要求

- **Neovim >= 0.10**
- **Git** (用于克隆插件)
- **C 编译器** (gcc/clang，tree-sitter 解析器需要)
- **ripgrep** (Telescope 搜索需要)
- **Nerd Font** (图标显示需要)

### Ubuntu / Debian

```bash
sudo apt update
sudo apt install neovim git build-essential ripgrep fd-find
# 剪贴板支持
sudo apt install xclip
```

### Arch Linux

```bash
sudo pacman -S neovim git base-devel ripgrep fd
```

### macOS

```bash
brew install neovim git ripgrep fd
```

---

## 快速开始

### 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://gitee.com/stesen/nvim_lua ~/.config/nvim
```

### 3. 首次启动

```bash
nvim
```

首次启动时，lazy.nvim 会自动安装自身及所有插件，稍等片刻即可。

---

## 目录结构

```
~/.config/nvim/
├── init.lua                    # 入口文件
├── lazy-lock.json              # 插件版本锁定
├── lua/
│   ├── plugins/                # 插件配置
│   │   ├── blink.lua           # 补全引擎
│   │   ├── cmp.lua             # 备用补全 (nvim-cmp)
│   │   ├── core.lua            # 核心依赖与通知
│   │   ├── editor.lua          # 编辑器增强
│   │   ├── git.lua             # Git 集成
│   │   ├── lsp.lua             # LSP 配置
│   │   ├── misc.lua            # 杂项工具
│   │   ├── telescope.lua       # 搜索
│   │   ├── treesitter.lua      # 语法高亮
│   │   └── ui.lua              # 界面美化
│   └── user/                   # 用户核心配置
│       ├── autocommands.lua    # 自动命令
│       ├── colorscheme.lua     # 主题 (catppuccin)
│       ├── keymaps.lua         # 键位映射
│       ├── lualine.lua         # 状态栏 (默认配置)
│       ├── options.lua         # 编辑器选项
│       ├── profiler.lua        # 性能分析
│       └── touch.lua           # 触摸手势支持
└── plugin/
    └── packer_compiled.lua     # 旧 packer 残留 (可忽略)
```

---

## 主要功能

| 类别 | 插件 |
|------|------|
| **插件管理** | lazy.nvim |
| **主题** | catppuccin, moonfly, kanagawa, dracula |
| **状态栏** | lualine.nvim |
| **缓冲区标签** | bufferline.nvim |
| **文件树** | neo-tree.nvim |
| **启动页** | alpha-nvim |
| **补全** | blink.cmp |
| **LSP** | mason.nvim, mason-lspconfig.nvim, nvim-lspconfig |
| **语法高亮** | nvim-treesitter |
| **搜索** | telescope.nvim + fzf-native |
| **Git** | gitsigns.nvim, neogit, lazygit.nvim |
| **终端** | toggleterm.nvim |
| **通知** | nvim-notify, noice.nvim |
| **自动括号** | nvim-autopairs |
| **注释** | Comment.nvim |
| ** surrounds** | vim-surround |
| **窗口分隔** | colorful-winsep.nvim |

---

## 快捷键速查

Leader 键为 `<Space>`。

### 基础操作

| 快捷键 | 功能 |
|--------|------|
| `jk` | 退出插入模式 |
| `<C-h/j/k/l>` | 窗口间导航 |
| `<C-Up/Down/Left/Right>` | 调整窗口大小 |
| `<S-h/l>` | 上一个/下一个缓冲区 |
| `<A-j/k>` | 上下移动当前行 |
| `<F4>` / `<leader>e` | 打开/关闭文件树 |
| `<F3>` | 打开 Legendary 命令面板 |

### 文件搜索 (Telescope)

| 快捷键 | 功能 |
|--------|------|
| `<leader>f` | 查找文件 |
| `<leader>g` | 全局搜索 (Live Grep) |
| `<F5>` | 搜索当前单词/选中内容 |

### LSP

| 快捷键 | 功能 |
|--------|------|
| `gd` | 跳转到定义 |
| `gD` | 跳转到声明 |
| `gr` | 查找引用 |
| `gi` | 查找实现 |
| `K` | 显示文档 |
| `<C-k>` | 显示签名帮助 |
| `[d` / `]d` | 上一个/下一个诊断 |
| `<leader>q` | 诊断列表 |

### Git

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

---

## 插件管理

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

---

## 故障排除

### 启动报错或插件未加载

```bash
rm -rf ~/.local/share/nvim/lazy
rm -rf ~/.cache/nvim
nvim
```

### 图标显示为方框

终端需要配置 Nerd Font（如 JetBrainsMono Nerd Font、MesloLGM Nerd Font）。

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

```vim
:TSInstall <language>
:TSInstallInfo
```

### 检查环境健康

```vim
:checkhealth
```

---

## 许可证

MIT License