nvim 是做什么的?
🌸 一个可爱的、原生支持 uv 的 Neovim 配置,专为 Python 和 AI/ML 开发打造——集成 pyrefly + ruff、blink.cmp + GitHub Copilot、Jupyter notebooks、DAP + neotest,并配以粉色主题和 Nyan-cat 状态栏 🐱
概述
本配置为 Python 和 AI/ML 开发者提供开箱即用的开发环境,核心特性包括:
- 原生 uv 支持:使用 uv 作为 Python 包管理器
- 类型检查与 linting:集成 pyrefly 和 ruff
- 智能补全:基于 blink.cmp 并支持 GitHub Copilot
- Jupyter notebook 集成:可直接在 Neovim 中编辑和运行 notebook
- 调试与测试:集成 nvim-dap 和 neotest
- 视觉主题:粉色主题搭配 Nyan-cat 动态状态栏 🐱
安装要求
- Neovim 0.9+(建议使用最新稳定版)
- 支持 Python 3.10+ 及 uv
- 可选:Nerd Font(用于图标显示)
- 可选:GitHub Copilot(需配置 token)
快速开始
# 克隆配置到配置目录
# 适用于 Linux/macOS
git clone https://github.com/kitkatdafu/nvim ~/.config/nvim
# 适用于 Windows(PowerShell)
git clone https://github.com/kitkatdafu/nvim $env:LOCALAPPDATA\nvim
# 启动 Neovim 并自动安装插件
nvim
首次启动时,Lazy.nvim 会自动安装所有插件。
依赖安装
确保已安装以下工具:
- uv(Python 包管理器)
- tree-sitter CLI:
uv tool install tree-sitter-cli - neotest 依赖:
uv tool install pytest(或其他测试框架)
配置要点
Python 设置
配置使用 uv 管理 Python 环境,并在项目根目录自动检测 pyproject.toml 或 .python-version。
-- 示例:在 init.lua 中覆盖默认设置
vim.g.python3_host_prog = '/path/to/python3'
主题切换
如需切换主题,修改 lua/plugins/colorscheme.lua 中的配置。
Copilot 配置
-- 在 lua/plugins/copilot.lua 中配置
require('copilot').setup({
suggestion = { enabled = true },
panel = { enabled = true },
})
支持平台
- macOS ✅ (完整测试)
- Linux ✅ (完整测试)
- Windows ✅(部分功能可能需要 WSL)
验证安装
运行 :checkhealth 查看所有依赖的安装状态。
贡献指南
欢迎提交 Issue 和 PR!请遵循以下原则:
- Fork 仓库并创建功能分支
- 保持配置模块化
- 更新相关文档
- 提交 PR 前运行
:checkhealth
许可证
本项目采用 MIT 许可证。