NEOVIM · GO · 30-DAY ROADMAP

三十天把 Nvim 变成 Go 开发主力环境

这条路线不是插件清单，而是一个可验收的训练计划：先建立 Vim 编辑心智，再用 Lua 组织配置， 接入 gopls 与 Go 工具链，最后用真实项目打磨测试、调试、重构和交付流程。 每天 45–75 分钟，原则是 少装插件，多跑项目；先能解释，再能自动化。

TOTAL 30 Days PACE 45–75 min / day PHASES 6 TARGET Go IDE 工作台 OUTPUT 配置仓库 + 真实项目

阶段总览

OVERVIEW
NVIM + GO 30-DAY ROADMAPPHASE 1编辑器根基Day 1 - 5PHASE 2IDE 能力Day 6 - 10PHASE 3Go 工作流Day 11 - 15PHASE 4调试与质量Day 16 - 20PHASE 5真实项目Day 21 - 26PHASE 6个人工作台Day 27 - 30SKILLS ACQUIREDVim MotionsLua ConfiggoplsTestingDelvenvim-dapRefactorpprofCI FlowFINAL OUTPUTSdotfiles / init.luaGo service projecttest / debug workflowone-command Go workspace
FIG · 从编辑器心智到 Go 项目交付的 30 天路径

每日节奏

TRAINING LOOP
45 - 75 MIN

固定训练循环

10 分钟复盘昨天的快捷键和配置；25 分钟学习一个新能力；25 分钟在 Go 项目中使用它；最后 5 分钟写日志，记录一个有效动作和一个卡点。

RULE

每天只让一个变量变复杂

学 Vim 动作时别折腾插件；学 LSP 时别重构业务；学调试时别同时换主题。复杂度分开，进步会更稳。

建议从一个真实但不大的 Go 项目开始：CLI 工具、HTTP API、脚本服务都可以，代码量 500–2000 行最合适。

编辑器根基

DAY 1 - 5

前五天只解决一件事：让你不再把 Nvim 当“缺少鼠标的 VS Code”，而是理解它自己的编辑模型。配置只做最少，重点是能稳定打开 Go 项目、移动、编辑、保存和恢复。

DAY 01 安装与健康检查 安装 Neovim、Go、ripgrep、fd；运行 :checkhealth 与 go version；建立专门的 dotfiles 仓库。查看 Day01 详细训练。
DAY 02 Vim 移动心智 练习 normal / insert / visual 三种模式；掌握 hjkl、word、line、paragraph、search 移动；输出一张个人快捷键纸。查看 Day02 详细训练。
DAY 03 文本对象与批量编辑 练习 ciw、di(、ya"、宏录制、点命令；用 Go 文件完成变量名、函数参数、注释的批量编辑。查看 Day03 详细训练。
DAY 04 Lua 配置结构 把 init.lua 拆成 options、keymaps、plugins、lsp；理解 require 和模块加载顺序。查看 Day04 详细训练。
DAY 05 Go 工具链入门 创建 go mod init 项目；跑通 go fmt、go test、go run；写一个小 CLI 作为后续练习项目。查看 Day05 详细训练。
阶段验收：你能不离开 Nvim 完成新建 Go 文件、快速移动、修改函数、保存、运行测试。

Go IDE 能力

DAY 6 - 10

这一阶段把 Nvim 接上 Go 的语言服务。目标不是“装很多插件”，而是知道 LSP、completion、diagnostics、formatting 各自解决什么问题，坏掉时该查哪里。

DAY 06 接入 gopls 安装 gopls；用 Neovim LSP 连接 Go 项目；配置 attach 后 keymap：定义、引用、悬浮说明、重命名。查看 Day06 详细训练。
DAY 07 代码导航与项目搜索 配置 fuzzy finder；练习文件、buffer、symbol、grep 搜索；用 :lua vim.lsp.buf.definition() 理解 LSP 请求。查看 Day07 详细训练。
DAY 08 补全与片段 接入补全插件或使用内置补全；只保留 Go 常用片段：函数、测试、表驱动测试、error return；避免把补全菜单调得过重。查看 Day08 详细训练。
DAY 09 格式化与导入整理 绑定保存时 gofmt / goimports / gofumpt；确认格式化来自 LSP 还是外部 formatter。查看 Day09 详细训练。
DAY 10 诊断、quickfix 与 trouble list 学习 diagnostics 浮窗、跳转、quickfix 列表；把编译错误、LSP 诊断、grep 结果放进同一个处理习惯里。查看 Day10 详细训练。
阶段验收：打开任意 Go 项目后，能完成定义跳转、引用追踪、重命名、保存格式化、定位诊断。

Go 开发工作流

DAY 11 - 15

现在开始把编辑器能力嵌进 Go 的日常开发：包结构、模块管理、测试、覆盖率和惯用写法。Nvim 只是入口，真正要形成的是“读代码、改代码、验证代码”的闭环。

DAY 11 包结构与模块边界 梳理 cmd/、internal/、package 命名、import path；用文件树和搜索建立项目地图。查看 Day11 详细训练。
DAY 12 表驱动测试 写 5 组 table-driven tests；配置快捷键运行当前文件、当前包、全部测试；学会从失败输出跳回代码。
DAY 13 覆盖率与 benchmark 跑 go test -cover、go test -bench；在 Nvim 中查看慢路径；避免只为覆盖率补空测试。
DAY 14 依赖与 go mod 练习 go get、go mod tidy、replace、workspace；学会读 go.sum 变化。
DAY 15 Go 惯用写法复盘 围绕 error、interface、defer、context、receiver 做一次代码审查；把 8 条个人 Go 规范写进 dotfiles 文档。
阶段验收：你能在 Nvim 内完成一个 Go package 的新增功能、测试、覆盖率检查和依赖整理。

调试与代码质量

DAY 16 - 20

第五周前要补上专业开发的硬能力：断点调试、日志定位、lint、安全扫描和构建条件。真正的主力环境不是好看，而是在出问题时能让你更快恢复判断。

DAY 16 Delve CLI 调试 安装 dlv；先在终端跑 dlv debug、break、continue、next、print；理解调试器不是 Nvim 插件的附属品。
DAY 17 nvim-dap 调试界面 接入 DAP；配置 launch / attach；绑定断点、单步、变量查看；用真实 bug 完成一次从断点到修复。
DAY 18 日志、panic 与错误路径 练习从 stack trace 跳到源码；用 quickfix 收集错误；把常见 panic、nil、context timeout 写成调试卡片。
DAY 19 lint、vet 与安全扫描 跑 go vet、staticcheck、govulncheck；区分编译错误、风格建议、安全风险；只把稳定规则放进自动化。
DAY 20 构建标签与运行环境 学习 build tags、环境变量、测试 fixture；在 Nvim terminal 中管理本地服务、测试命令和运行参数。
阶段验收：面对一个失败测试或线上风格 bug，你能用日志、断点、诊断和 lint 找到原因，而不是靠猜。

真实项目实战

DAY 21 - 26

接下来六天只围绕一个项目推进。推荐做一个“小而完整”的 HTTP 服务：有配置、有路由、有存储、有并发、有测试、有性能观察。不要再为插件而插件。

DAY 21 项目骨架与任务入口 创建 cmd/、internal/、Makefile 或 taskfile；在 Nvim 里绑定 build、test、run 三个入口。
DAY 22 HTTP API 与路由 实现 2–3 个 handler；用跳转、引用、重命名维护结构；写 handler 单测和集成测试。
DAY 23 配置、存储与边界 加入配置读取和简单存储层；练习 interface 边界；用 mock 或 fake 写测试，不让测试依赖真实外部系统。
DAY 24 并发与 context 实现一个带超时的后台任务；理解 goroutine、channel、context cancel；用测试验证取消路径。
DAY 25 性能观察与 pprof 跑 benchmark，打开 pprof；定位一个慢函数；记录“观察证据 → 修改 → 再测”的过程。
DAY 26 一次完整重构 选择一个真实坏味道：函数过长、依赖方向错、测试难写；用 LSP 重命名、引用、诊断完成重构。
阶段验收：项目能一条命令跑起来，测试可重复，核心功能有覆盖，调试和性能记录能追溯。

个人 Go 工作台

DAY 27 - 30

最后四天把学习成果固化。一个好的 Nvim Go 环境应该可复制、可解释、可回滚；你要能在新机器上恢复，也能向同事说明每个插件为什么存在。

DAY 27 配置模块化与文档化 拆分 lsp、dap、formatter、keymaps、ui；给每个模块写一句用途说明；删除 30 天里没实际用过的插件。
DAY 28 插件更新与回滚策略 理解 lockfile；建立每周更新节奏；更新后跑 :checkhealth、打开 Go 项目、跑测试、试一次 debug。
DAY 29 Git、CI 与团队协作 把 gofmt、go test、go vet、govulncheck 放进 CI；用 Nvim 完成一次 issue → branch → commit → review 的闭环。
DAY 30 毕业项目与个人手册 从零开一个 Go 项目，30 分钟内完成初始化、LSP、测试、调试、提交；写下你的 Nvim Go 开发 SOP。
最终验收：新项目启动后一小时内，你能完成从编码到测试、调试、重构、提交的完整开发循环。

关键配置速查

COMMANDS
INSTALL

基础工具

$ brew install neovim go ripgrep fd tree-sitter
$ go install golang.org/x/tools/gopls@latest
$ go install github.com/go-delve/delve/cmd/dlv@latest
$ go install golang.org/x/vuln/cmd/govulncheck@latest
NVIM

日常检查

:checkhealth
:LspInfo
:InspectTree
:lua vim.print(vim.lsp.get_clients())
:copen

核心映射建议

能力建议快捷键验收动作
定义跳转gd从 handler 跳到 service、repo、类型定义，并能快速跳回。
引用查找gr重构前确认函数被哪些包使用。
重命名<leader>rn跨文件重命名结构体字段，测试仍然通过。
运行当前包测试<leader>tp改完函数后不离开 Nvim 就能验证当前 package。
调试启动<leader>dc设置断点，进入 handler，查看变量，继续执行。
诊断列表<leader>xx把 LSP 诊断、测试失败、grep 结果统一收敛到列表里。

参考资料

PRIMARY SOURCES
NEOVIM

Neovim LSP 与配置

Neovim health 文档 解释了 :checkhealth；Neovim LSP 文档 解释了内置 LSP 客户端；nvim-lspconfig 提供常见语言服务器配置入口。

GO

Go 官方学习材料

Go 入门教程、Effective Go、模块依赖管理 是学习 Go 工作流的主线资料。

GOPLS

Go 语言服务器

gopls 是 Go 官方语言服务器，是 Nvim 中跳转、诊断、重命名和代码动作的核心来源。

DEBUG

Delve 与 DAP

Delve 是 Go 调试器；nvim-dap 把 Debug Adapter Protocol 接入 Neovim。

neovim.io go.dev gopls Delve nvim-dap govulncheck

不要踩的坑

CHECKLIST
  1. 先插件后能力。 看到插件就装，最后只会得到一份不可解释的配置。每个插件必须回答：它替代了哪个动作，失败时如何降级。
  2. 只改配置，不写 Go。 Nvim 是开发环境，不是学习终点。每天至少在真实 Go 文件里完成一个可运行改动。
  3. 把 LSP、formatter、lint 混为一谈。 gopls 负责语言理解，formatter 负责格式，lint 负责规则。问题定位时先拆清来源。
  4. 忽略调试器 CLI。 nvim-dap 坏了时，能不能用 dlv 独立复现，是判断你是否真正理解调试的分水岭。
  5. 过早追求团队级配置。 第一个月先做个人工作台；等你能稳定解释每个设置，再考虑抽象成团队模板。

少装一个没用过的插件，多完成一次真实的编码、测试、调试和提交。

NVIM + GO 30-DAY ROADMAP · EDITOR TO DELIVERY