应手动用 go mod init 初始化并按 cmd/internal/pkg/api 分层建骨架，因第三方模板常硬编码过时结构、忽略 internal 导入限制或放错 main.go；官方约定经工具链验证，go mod init 必须在建目录前执行。
直接用
初始化模块，再按 Go 官方推荐的
、
、
、
等目录分层建好骨架，比任何插件或模板都可靠、无歧义。
为什么不用第三方模板或 VSCode 插件生成结构
多数插件（如
或社区脚手架）要么硬编码过时结构（比如强塞
），要么忽略
的导入限制语义，甚至把
放错位置导致
失败。Go 官方从不定义“标准工程目录”，但
存可执行入口、
存私有逻辑、
存可复用包——这些是经
工具链长期验证的约定，不是风格偏好。
下每个子目录必须含
，且
，否则
会报
目录名不能拼错（比如写成
），否则 Go 不会强制阻止跨模块导入，失去封装意义
VSCode 的
里如果装了
，它只认真实存在的
和目录层级，不会帮你补结构
手动创建符合官方实践的最小可行结构
在终端中进入项目根目录，逐条执行（别跳步）：
然后填入最简内容：
go语言参考手册 中文CHM版
Go 是一个开源的编程语言，它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册，需要的可以来下载！ Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发，后来还加入了Ian Lance Taylor, Russ Cox等人，并最终于2009年11月开源，在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的，并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译
下载
：必须是
+
，否则无法构建为二进制
：用
，确保路径与包名一致，避免
报错
文件里的 module 名建议用真实域名（哪怕本地开发），否则
或依赖替换会出问题
VSCode 中快速补全和校验的关键点
装好
后，VSCode 会自动识别结构，但需主动触发校验：
按
（macOS 是
），输入
，确保
、
版本兼容（1.21+ 推荐）
右键点击
目录 →
，看是否输出二进制；失败时先检查
是否真在该目录下
在
外的任意文件里 import
，应被允许；但若在另一个模块里 import 这个路径，
会直接报错——这是对的，不是 bug
真正容易被忽略的是
初始化时机：必须在建任何子目录前运行
，否则后续
命令可能误判模块根路径，导致
漏掉
下的包。
go mod initcmdinternalpkgapiGo: Generate Modulesrc/internalmain.gogo runcmd/internal/pkg/gocmd/main.gopackage maingo build ./cmd/xxxno Go files ininternal/internalsGo: Install/Update Toolsgoplsgo.modgo mod init example.com/myapp
mkdir -p cmd/myapp internal/handler internal/repository pkg/utils
touch cmd/myapp/main.go internal/handler/handler.go pkg/utils/helpers.gocmd/myapp/main.gopackage mainfunc main()internal/handler/handler.gopackage handlergo listgo.modgo getgoplsCtrl+Shift+PCmd+Shift+PGo: Verify Go Toolsgoplsgocmd/myappGo: Build Packagemain.gointernal/"example.com/myapp/internal/handler"go buildgo.modgo mod initgogo list ./...internal