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 天学习路线阶段总览
NVIM + GO 30-DAY ROADMAP
PHASE 1
编辑器根基
Day 1 - 5
PHASE 2
IDE 能力
Day 6 - 10
PHASE 3
Go 工作流
Day 11 - 15
PHASE 4
调试与质量
Day 16 - 20
PHASE 5
真实项目
Day 21 - 26
PHASE 6
个人工作台
Day 27 - 30
SKILLS ACQUIRED
Vim Motions
Lua Config
gopls
Testing
Delve
nvim-dap
Refactor
pprof
CI Flow
FINAL OUTPUTS
dotfiles / init.lua
Go service project
test / debug workflow
one-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 入门教程、Effective Go、模块依赖管理是学习 Go 工作流的主线资料。

GOPLS

Go 语言服务器

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

DEBUG

Delve 与 DAP

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

neovim.iogo.devgoplsDelvenvim-dapgovulncheck

不要踩的坑

CHECKLIST

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

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

NVIM + GO 30-DAY ROADMAP · EDITOR TO DELIVERY