go mod init 是新建 go 项目的实际起点，必须在项目根目录执行并指定与 import 路径一致的模块名（如 github.com/user/repo），否则会导致 import 不生效、ide 无法识别、构建失败等问题。
go mod init 是新建 Go 项目的实际起点，不是视频教程能绕开的步骤。所有“新建项目”操作本质都是这一条命令加配套目录结构，视频只是演示敲键盘的过程，真正卡住你的从来不是“怎么点鼠标”，而是执行后报错、模块不生效、IDE 识别不了包——这些都得靠理解命令本身。
go mod init 后为什么 import 不生效？
常见现象：执行 go mod init myapp 后，在 main.go 里写 import "./utils" 或 import "myapp/utils"，VS Code 提示 “could not import”，go run main.go 报 no required module provides package。
- 根本原因：Go Modules 要求 import 路径必须是模块路径（即
go.mod第一行module xxx声明的值），不能用相对路径如./utils - 正确做法：先确保
go.mod中module值合法（如module myapp），再把utils放在同级子目录，然后import "myapp/utils" - 注意：如果项目路径含空格或中文，
go mod init会静默失败，生成的go.mod为空或格式异常，务必检查终端输出
vscode 打不开 Go 项目？检查这三处
不是插件没装，而是 Go 环境和工作区配置没对齐。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
GO111MODULE必须为on：运行go env -w GO111MODULE=on，否则 VS Code 的 Go 插件默认走 GOPATH 模式，完全无视go.mod - VS Code 工作区必须打开项目根目录（即含
go.mod的目录），不能只打开main.go文件，否则插件找不到模块上下文 - 确认
GOPROXY可用：国内建议设为https://goproxy.cn，避免go get卡死导致依赖解析失败
初始化时要不要指定模块路径？
要，而且必须和你未来 import 的路径一致。
- 本地练习项目：用简单名字即可，如
go mod init demo→ 后续import "demo/utils" - 将来可能推送到 GitHub：直接按远程路径初始化，如
go mod init github.com/yourname/myapp，避免后期改go.mod和全量替换 import - 错误示范：
go mod init .或go mod init不带参数 —— Go 会尝试从路径推导，但容易出错，尤其路径含空格、符号或不在 GOPATH 时
go build 能过、go test 能跑、IDE 能跳转、别人 clone 下来也能立刻编译——这四点全满足，才算项目立住了。其他全是表象。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
