新建Go项目需确保main.go在模块根目录、配置国内GOPROXY（如https://goproxy.cn,direct）、执行go mod tidy，否则go run报错、依赖拉不下、VS Code提示“no Go files”或加载失败。
Go 环境装好了，go version 能跑，但新建项目时卡在 go mod init 报错、依赖拉不下来、VS Code 提示“no Go files”——这不是环境没装好，是工程初始化环节漏了关键配置。
go mod init 之后为什么 go run 还报错找不到包？
常见现象：执行 go mod init example.com/hello 后，go run main.go 报 package command-line-arguments is not in GOROOT 或 cannot find package。
- 根本原因不是模块名写错，而是
main.go里写的package main没问题，但文件没放在当前目录下——你可能误把main.go创建在子目录（比如src/）里，而go run只认当前目录下的.go文件 -
go mod init不会自动创建main.go，必须手动新建且确保它在模块根目录 - 模块名（如
example.com/hello）只是逻辑标识，不影响运行，但若用go install安装到$GOPATH/bin，模块名需全局唯一（实际开发中建议用真实域名或 GitHub 路径）
国内环境下 GOPROXY 必须配，否则 go get 直接超时
默认代理 proxy.golang.org 在国内基本不可用，go get 或 go mod download 会卡死或报 timeout、no such host。
- 推荐配置（永久生效）：
go env -w GOPROXY=https://goproxy.cn,direct - 如果公司有私有代理，可替换为内网地址，例如：
go env -w GOPROXY=https://goproxy.internal.company.com,direct -
direct表示对校验和服务器（sum.golang.org）等跳过代理——若该地址也被墙，需额外配go env -w GOSUMDB=off（仅开发环境临时用，生产禁用） - 验证是否生效：运行
go env GOPROXY，输出应为设置的地址；再执行go mod download github.com/go-sql-driver/mysql，成功即表示通了
一键初始化工程目录的可靠命令组合
别再手敲一堆 mkdir + touch + go mod init，用这组命令直接生成可用结构：
立即学习“go语言免费学习笔记（深入）”；
- 创建项目并初始化模块：
mkdir myapp && cd myapp && go mod init myapp - 生成标准
main.go（含基础 import 和 main 函数）：cat > main.go <<'EOF' package main import "fmt" func main() { fmt.Println("Hello, Go!") } EOF - 验证运行：
go run main.go输出Hello, Go!即成功 - 如需快速加 HTTP 服务模板，追加：
echo 'import _ "net/http/pprof"' >> main.go，然后在main()里加http.ListenAndServe(":8080", nil)
真正容易被忽略的是：VS Code 的 Go 扩展默认依赖 gopls，而 gopls 启动时会读取 go.mod 并检查依赖完整性。如果 go mod init 后没跑过 go mod tidy，或者 GOPROXY 没生效，编辑器就会一直显示 “Loading…” 或标红 import 行——这时候不是插件坏了，是模块状态没拉齐。
