答案是路径含空格或中文导致模块路径非法；应切换至纯英文无空格路径（如d:\golang\hello），执行go mod init合法小写模块名（如example.com/hello），并确保无残留go.mod文件。
go mod init 为什么总报错“module path should not contain spaces”
常见错误是直接在含中文、空格或特殊字符的路径下执行 go mod init，比如桌面路径 C:\Users\张三\Desktop\my project。Go 模块路径会自动推导为目录名，而模块路径规范禁止空格和非 ASCII 字符。
- 新建项目时，先在终端 cd 到一个纯英文、无空格、无中文的路径，例如
D:\golang\hello或~/go-projects/hello - 运行
go mod init hello（模块名建议用小写英文，可与目录名不同，但必须合法） - 如果已建错，删掉当前目录下的
go.mod和go.sum，再换路径重试 - GoLand 中右键项目 → “Reload project” 不会自动修复错误路径，必须手动删 mod 文件并重新 init
go mod tidy 没反应或卡住，是不是代理没生效
90% 的 go mod tidy 卡顿源于代理配置不完整或未生效。尤其注意：只设 GOPROXY=https://goproxy.cn 是不够的，缺了 direct 会导致私有模块或本地 replace 失败，进而阻塞整个解析流程。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 正确命令是：
go env -w GOPROXY=https://goproxy.cn,direct（逗号分隔，direct必须存在） - 验证是否生效：
go env GOPROXY输出应为https://goproxy.cn,direct，不是空或https://proxy.golang.org - 若公司有私有仓库，还需加
go env -w GOPRIVATE=git.company.com/internal/*，否则tidy会尝试走代理拉取，超时卡死 - GoLand 内置终端可能未加载最新环境变量，建议在系统终端执行
tidy，成功后再刷新 IDE 索引
GoLand 显示“unresolved reference”但 go build 能过，怎么回事
这是 IDE 索引与模块根目录不一致的典型表现。GoLand 依赖 go.mod 文件定位模块边界，一旦项目结构嵌套或工作区里混了多个模块，就容易误判。
- 检查当前打开的是否为模块根目录：IDE 左上角项目名旁应显示 “(mod)” 标识；若显示 “(GOPATH)” 或无标识，说明没识别到
go.mod - 删除项目根目录下的
go.work文件（多模块工作区文件），它会强制 GoLand 进入工作区模式，干扰单模块项目加载 - 关闭项目，用系统终端进入模块根目录，执行
go mod vendor（可选），再重新用 GoLand 打开该目录（不是父目录） - 右键项目 → “Reload project” 后，仍红标？点菜单栏 “File → Invalidate Caches and Restart → Just Restart”，避免旧索引残留
vendor 目录生成后 IDE 还是提示包找不到
go mod vendor 只是把依赖复制进 vendor/，但 GoLand 默认仍走模块路径而非 vendor，除非显式启用 vendor 模式。
- 进入
Settings → Go → Build Tags & Vendoring - 勾选
Enable vendoring support（关键一步，不勾选等于白做） - 确认
Vendor directory路径为vendor（默认值，一般不用改） - 勾选后点击 OK，IDE 会重新索引，此时 import 语句才真正从
vendor/解析 - 注意：
go run和go build默认不读 vendor，需加-mod=vendor参数才生效，IDE 运行配置里也要手动加上
go.mod 的物理位置。任一错位，就会出现“命令行能跑，IDE 报错”或“IDE 补全正常，go test 找不到包”的割裂现象。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
