Neovim 配置

项目简介

一套轻量、易扩展的 Neovim 配置，开箱即用，适合日常编码与学习。

主要特性与插件

• 🐬 启动面板：alpha-nvim 启动界面，海豚 ASCII 艺术，最近项目快速访问
• 🎨 外观：One Dark Pro 主题，透明背景支持，which-key 快捷键提示
• 🔧 开发工具：LSP (Pyright/clangd/jsonls/marksman/buf)，智能补全，AI 辅助 (Codeium/windsurf.nvim)
• 📂 导航：neo-tree 文件树，Telescope 模糊搜索，Flash 快速跳转，项目管理
• 🐍 Python 支持：venv-selector.nvim 虚拟环境管理（支持 .venv/Poetry/Conda），与 Pyright LSP 深度集成
• 🌿 Git 集成：gitsigns 状态显示，diffview 可视化 diff 工具
• 🖥️ 终端管理：toggleterm 多终端支持，自动激活 Python venv
• 📐 代码折叠：基于 Tree-sitter 的智能折叠
• 🎯 快速跳转：flash.nvim 增强 f/t 跳转，支持可视化标签

详细插件列表请查看：docs/PLUGINS.md

环境要求

基础环境

• Neovim ≥ 0.11（必须）

需要手动安装的工具

以下工具无法通过 Mason 自动安装，需要通过系统包管理器手动安装：

工具	用途	是否必须	安装方式
Node.js	Mason 安装部分工具的依赖	必须	brew install node / 官网下载
Python 3	Python 开发环境	开发 Python 时必须	brew install python3 / apt install python3
C 编译器	tree-sitter 编译语法解析器	必须	xcode-select --install (macOS) / apt install build-essential (Linux)
ripgrep	Telescope 全局搜索	强烈推荐	brew install ripgrep / apt install ripgrep
fd	venv-selector 搜索 Python 虚拟环境	开发 Python 时必须	brew install fd / apt install fd-find
Nerd Font	图标显示	推荐	下载 JetBrainsMono Nerd Font

快速安装：

# macOS
brew install node python3 ripgrep fd
xcode-select --install  # 安装 C 编译器
brew install --cask font-jetbrains-mono-nerd-font

# Ubuntu/Debian
sudo apt install nodejs python3 python3-pip build-essential ripgrep fd-find

Mason 自动安装的工具 ✅

以下工具会在 Neovim 启动后 3 秒自动安装，无需手动操作：

LSP 服务器：pyright, jsonls, marksman, clangd 开发工具：stylua, prettier, ruff, buf (Protocol Buffers LSP+formatter)

💡 提示：首次启动后可通过 :Mason 查看所有工具的安装状态。

快速上手

1. 克隆仓库
   • Linux/macOS

     git clone https://github.com/chenggouA/neovim-config.git ~/.config/nvim

   • Windows

     git clone https://github.com/chenggouA/neovim-config.git $Env:LOCALAPPDATA\nvim

2. 首次启动 打开 Neovim，lazy.nvim 与所有插件会自动安装。安装完成后即可使用。

配置说明

• init.lua：入口文件，加载基础选项与插件
• lua/core/：核心配置，如选项、工具函数、Python 支持等
• lua/plugins/：插件定义与自定义配置

快捷键速览

Leader 键：Space（空格）

常用快捷键

快捷键	功能
<leader>o	打开启动面板
<leader>e	打开/聚焦文件树
<leader>ff	查找文件
<leader>fg	全局搜索
<leader>"	查看寄存器
<leader>cf	格式化代码
<leader>cn	LSP 重命名
<leader>ca	代码操作
<leader>vs	选择 Python 虚拟环境
s	Flash 快速跳转

完整的快捷键速查表请查看：docs/KEYMAPS.md

常见问题 / 排错

• tree-sitter 编译失败：确认已安装 GCC/Clang 等 C 编译器。
• 系统剪贴板未同步：默认不与系统剪贴板共享，可使用 <leader>y 复制、<leader>p 粘贴。

升级与维护

• 使用 :Lazy sync 或 :Lazy update 更新插件
• 建议在升级前备份 lazy-lock.json

许可证与致谢

本项目基于 MIT 许可证 开源。 感谢所有开源插件作者的贡献。