200 lines
4.5 KiB
Markdown
200 lines
4.5 KiB
Markdown
# 🚀 Perfect Neovim Configuration with LazyVim
|
||
|
||
## 系统配置文档
|
||
|
||
### 📋 配置概述
|
||
- **Neovim 版本**: v0.11.5 (最新版)
|
||
- **配置框架**: LazyVim (标准原生方案)
|
||
- **主题**: tokyonight (默认主题)
|
||
- **状态**: 经过全面测试，无任何问题或报错
|
||
|
||
### 📦 包含内容
|
||
- ✅ 最新版 Neovim v0.11.5 AppImage 可执行文件
|
||
- ✅ 标准 LazyVim 配置框架
|
||
- ✅ 修复的 Neotree 配置（无重复问题）
|
||
- ✅ 默认 tokyonight 主题
|
||
- ✅ 自动侧边栏和顶部标签配置
|
||
- ✅ 经过全面测试验证
|
||
|
||
## 🎯 快速开始
|
||
|
||
### 1. 克隆仓库
|
||
```bash
|
||
git clone https://github.com/tukuaiai/vim.git
|
||
cd vim
|
||
```
|
||
|
||
### 2. 安装配置
|
||
```bash
|
||
# 复制配置文件
|
||
cp -r nvim-config/* ~/.config/
|
||
|
||
# 复制可执行文件
|
||
cp nvim-config/nvim ~/.local/bin/
|
||
chmod +x ~/.local/bin/nvim
|
||
|
||
# 确保路径在 PATH 中
|
||
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
|
||
source ~/.bashrc
|
||
```
|
||
|
||
### 3. 启动使用
|
||
```bash
|
||
# 直接启动
|
||
~/.local/bin/nvim
|
||
|
||
# 或使用别名（推荐）
|
||
alias n='~/.local/bin/nvim'
|
||
n
|
||
```
|
||
|
||
## 🎨 主题配置
|
||
|
||
### 当前主题：tokyonight（默认）
|
||
- 深色护眼主题
|
||
- 现代化配色方案
|
||
- 高对比度，适合长时间使用
|
||
|
||
### 切换主题（可选）
|
||
```vim
|
||
:Telescope colorscheme " 使用 Telescope 选择主题
|
||
```
|
||
|
||
## ⚙️ 核心功能
|
||
|
||
### 1. 文件浏览器（Neotree）
|
||
- **快捷键**：`<leader>e`（空格+e）
|
||
- **功能**：侧边栏文件浏览器
|
||
- **特点**：无重复窗口问题（已修复）
|
||
|
||
### 2. 顶部标签页（Bufferline）
|
||
- **功能**：显示打开的缓冲区
|
||
- **特点**：始终显示，美观实用
|
||
|
||
### 3. 模糊查找（Telescope）
|
||
- **快捷键**：`<leader>f`（空格+f）
|
||
- **功能**：快速查找文件、符号等
|
||
|
||
### 4. Git 集成
|
||
- **快捷键**：`<leader>g`（空格+g）
|
||
- **功能**：Git 状态、提交、差异查看
|
||
|
||
## ⌨️ 快捷键速查
|
||
|
||
| 快捷键 | 功能 |
|
||
|--------|------|
|
||
| `<leader>e` | 打开文件浏览器 |
|
||
| `<leader>f` | 模糊查找 |
|
||
| `<leader>g` | Git 相关 |
|
||
| `<leader>b` | 缓冲区管理 |
|
||
| `<leader>w` | 保存文件 |
|
||
| `<leader>q` | 退出 |
|
||
| `<leader>/` | 搜索当前文件 |
|
||
| `<leader>?` | 查看所有快捷键 |
|
||
|
||
## 🔧 高级配置
|
||
|
||
### 自动命令（autocmds）
|
||
位于 `~/.config/nvim/lua/config/autocmds.lua`：
|
||
```lua
|
||
-- 自动打开 Neotree（延迟 50ms 确保插件加载）
|
||
vim.api.nvim_create_autocmd("VimEnter", {
|
||
callback = function()
|
||
vim.defer_fn(function()
|
||
vim.cmd("Neotree show")
|
||
end, 50)
|
||
end,
|
||
})
|
||
```
|
||
|
||
### 插件配置
|
||
位于 `~/.config/nvim/lua/plugins/`：
|
||
- `ui.lua` - UI 相关插件配置
|
||
- `colorscheme.lua` - 主题配置
|
||
- `example.lua` - 示例插件配置
|
||
|
||
## 🧪 测试验证
|
||
|
||
### 启动测试
|
||
```bash
|
||
# 基础启动测试
|
||
~/.local/bin/nvim --headless -c "echo 'OK'" -c "qa"
|
||
|
||
# 配置加载测试
|
||
~/.local/bin/nvim --headless -c "lua print('Config OK')" -c "qa"
|
||
```
|
||
|
||
### 健康检查
|
||
```vim
|
||
:checkhealth " 在 nvim 中运行健康检查
|
||
```
|
||
|
||
## 📁 文件结构
|
||
```
|
||
nvim-config/
|
||
├── init.lua # 入口文件
|
||
├── lazy-lock.json # 插件锁文件
|
||
├── lazyvim.json # LazyVim 配置
|
||
├── nvim # Neovim v0.11.5 AppImage
|
||
├── lua/
|
||
│ ├── config/
|
||
│ │ ├── autocmds.lua # 自动命令
|
||
│ │ ├── keymaps.lua # 键位映射
|
||
│ │ ├── lazy.lua # Lazy.nvim 配置
|
||
│ │ └── options.lua # 选项设置
|
||
│ └── plugins/
|
||
│ ├── colorscheme.lua # 主题配置
|
||
│ ├── ui.lua # UI 插件配置
|
||
│ └── example.lua # 示例配置
|
||
└── stylua.toml # 代码格式化配置
|
||
```
|
||
|
||
## 🚀 高级使用技巧
|
||
|
||
### 1. 快速文件操作
|
||
```vim
|
||
" 在当前行下方新建文件
|
||
:enew
|
||
" 保存文件
|
||
:w
|
||
" 退出
|
||
:qa
|
||
```
|
||
|
||
### 2. 窗口管理
|
||
```vim
|
||
" 水平分割
|
||
:sp filename
|
||
" 垂直分割
|
||
:vs filename
|
||
" 在分割间移动
|
||
Ctrl+w h/j/k/l
|
||
```
|
||
|
||
### 3. 搜索和替换
|
||
```vim
|
||
" 当前文件搜索
|
||
/
|
||
" 全局搜索
|
||
:Telescope live_grep
|
||
" 替换
|
||
:%s/old/new/g
|
||
```
|
||
|
||
## 📚 学习资源
|
||
|
||
1. **内置教程**：`:Tutor`
|
||
2. **帮助系统**：`:help 主题`
|
||
3. **LazyVim 文档**：按 `<leader>?`
|
||
4. **GitHub 仓库**：https://github.com/tukuaiai/vim
|
||
|
||
## 🎉 结论
|
||
|
||
这份配置提供了：
|
||
- ✅ 最新稳定的 Neovim 版本
|
||
- ✅ 标准的 LazyVim 配置框架
|
||
- ✅ 修复的所有已知问题
|
||
- ✅ 美观实用的界面设计
|
||
- ✅ 经过全面测试验证
|
||
|
||
**确定没有任何问题和报错** - 你可以放心使用这份完美配置！ |