# nvim **Repository Path**: graviton/nvim ## Basic Information - **Project Name**: nvim - **Description**: No description available - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-18 - **Last Updated**: 2026-11-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Neovim 配置 个人 Neovim 配置,包含 lazy.nvim、原生 LSP、Mason、补全、Conform 和 Treesitter。 ## 配置目录 - Windows:`%LOCALAPPDATA%\nvim` - Linux / macOS:`${XDG_CONFIG_HOME:-~/.config}/nvim` 只跟踪配置和 `lazy-lock.json`,不跟踪插件、语言服务器、解析器、日志或编辑历史。它们位于 Neovim 的数据目录,可以在 Neovim 中用 `:lua print(vim.fn.stdpath('data'))` 查看。 ## 首次部署 需要支持 `vim.lsp.config()` / `vim.lsp.enable()` 的 Neovim(0.11 或更新版本);当前在 Windows Neovim 0.13 开发版使用。插件的版本要求也应满足。 安装 Git,然后将本仓库克隆到相应系统的配置目录。当前配置不会自动安装 lazy.nvim,需要先执行: ```powershell # Windows PowerShell git clone --branch=stable https://github.com/folke/lazy.nvim.git "$env:LOCALAPPDATA\nvim-data\lazy\lazy.nvim" ``` ```sh # Linux / macOS git clone --branch=stable https://github.com/folke/lazy.nvim.git "${XDG_DATA_HOME:-$HOME/.local/share}/nvim/lazy/lazy.nvim" ``` 启动 Neovim,运行 `:Lazy restore`,按 `lazy-lock.json` 恢复插件版本。Mason 会尝试安装配置中列出的语言服务器;运行 `:Mason` 检查安装状态。 ## 外部工具 按实际使用的语言安装工具,并确保 Neovim 能从 PATH 找到它们: - C/C++ LSP:Clice(`clice serve`),项目需要有效的编译数据库。 - Treesitter:tree-sitter CLI、可用的 C 编译器、curl、tar。版本要求以锁定的 nvim-treesitter 文档为准。 - Telescope 文本搜索:ripgrep(`rg`)。 - 格式化:stylua、ruff、prettier、gofmt、rustfmt、clang-format,按语言选装。 - 图标:终端使用 Nerd Font。 解析器需显式安装,不会在每次启动时自动下载: ```vim :TSInstall bash c cpp python rust go haskell scheme javascript typescript tsx json toml markdown markdown_inline lua vim vimdoc query yaml html css ``` Fish 和 Nushell 可以根据当前插件支持情况另行安装 `fish`、`nu` 解析器。 ## 操作系统差异 `master` 保存公共配置,目前没有单独的系统分支。若以后需要系统专属配置,可以在对应机器上从 master 创建 `windows`、`linux` 或 `macos` 分支,例如 `git switch -c windows`。公共修复合入 master 后,各系统分支可通过 `git merge master` 同步。 ## 隐私 不要提交凭据、个人日志、会话或编辑历史。`.gitignore` 忽略 `.env`、`local.lua` 和 `lua/config/local.lua` 等本机文件;当前配置不会自动加载这些 Lua 文件,需要使用时自行添加加载逻辑。 提交到远程仓库前检查 `git diff --cached`。Git 提交也会记录本机配置的作者姓名和邮箱。