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

Go IDE 能力

DAY 6 - 10

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

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

Go 开发工作流

DAY 11 - 15

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

DAY 11 包结构与模块边界 梳理 cmd/、internal/、package 命名、import path；用文件树和搜索建立项目地图。
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 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