GoLand 配置 Harbor 凭证仅用于 IDE 内 Docker 操作（如拉取镜像、构建镜像），不影响 Go 编译或代码逻辑；必须启用 Docker 插件并在 Settings → Services → Docker Registry 中添加 Docker V2 类型 registry，使用 robot account 并验证连接成功；实际构建时 docker daemon 需单独执行 docker login，且需确保证书可信、镜像地址完整、CI/CD 独立认证。
GoLand 里配置 Harbor 或其他私有 registry 的凭证不是为了 Go 编译，而是为了 Docker 操作
GoLand 本身不拉取或运行 Go 模块，它只是调用 docker CLI 命令（比如 docker pull、docker build）。你配置的 registry 凭证，只影响 IDE 在「服务」工具窗口中点击拉取镜像、或右键 Dockerfile →「Build Image」这类操作能否成功。Golang 微服务代码里完全不感知这个配置。
常见错误现象：docker pull harbor.example.com/project/app:v1.2.0 在终端能跑通，但在 GoLand 里点「Pull」失败，报 unauthorized: authentication required —— 这说明 IDE 没拿到凭据，不是镜像地址或证书问题。
- 必须启用 Docker 插件（Settings → Plugins → 搜索并启用
Docker） - 在 Settings → Services → Docker Registry 中添加新 registry，类型选
Docker V2（不要选 Docker Hub） - 注册表地址填完整 URL：例如
https://harbor.example.com或harbor.example.com:443（端口显式写出更稳） - 用户名/密码填 robot account（如
robot$project-puller）或项目级账号，**不能填个人账号**（Harbor robot account 权限可控、可轮换） - 添加后底部显示
Connection successful才算真正通了；如果卡住，先在终端验证curl -u user:pass https://harbor.example.com/api/v2.0/projects
为什么填了凭证还是拉不到？检查三个关键路径是否对齐
GoLand 的 registry 配置只管「IDE 界面操作」，但真实构建流程往往绕过它。比如你在 Dockerfile 里写 FROM harbor.example.com/base/golang:1.22-alpine，然后点「Build Image」，此时实际执行的是 docker build，而它是否能拉基础镜像，取决于：
-
docker daemon是否已登录：运行docker login harbor.example.com（不是 GoLand 登录） -
daemon.json是否信任 Harbor 的证书：私有 CA 必须把ca.crt放到/etc/docker/certs.d/harbor.example.com:443/ca.crt - Dockerfile 中的镜像地址是否带协议和端口：错写成
harbor/base/golang会被当成 Docker Hub 地址，必然 404
最容易被忽略的一点：GoLand 构建时默认使用系统 Docker daemon，它不读 IDE 里配的 registry 凭据，只认 ~/.docker/config.json 里的 auths 字段。所以你得手动 docker login，或者让 CI/CD 流水线提前注入。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
CI/CD 流水线中拉私有基础镜像，别依赖 GoLand 配置
GoLand 是开发工具，不是部署环境。生产构建（Jenkins/GitLab Runner）必须独立完成认证，否则 docker build 会卡在 FROM 行。
- 在构建脚本开头加
docker login -u "$ROBOT_USER" -p "$ROBOT_TOKEN" https://harbor.example.com - 确保 runner 宿主机的
/etc/hosts或 DNS 能解析harbor.example.com（很多失败是 ping 不通） - 若用
nerdctl（如在 K3s 环境），需额外配置nerdctl login，它不复用docker login的凭据 - 避免在 Dockerfile 中硬编码 token：
FROM https://token:xxx@harbor.example.com/base/golang—— 这种写法暴露密钥且不被所有客户端支持
GoLand 拉镜像失败时，优先看日志里调用的是哪条 docker 命令
GoLand 底层就是拼接 shell 命令。打开 View → Tool Windows → Services → 右键镜像节点 → 「Show Log」，你能看到它实际执行的 docker pull ... 全命令。重点核对：
- 命令中镜像名是否和你 registry 配置的域名一致（比如配置的是
harbor.example.com，但日志里却是harbor.internal） - 是否出现
x509: certificate signed by unknown authority—— 这是证书问题，和凭据无关 - 是否返回
no basic auth credentials—— 说明 daemon 没登录，GoLand 配置没生效，得补docker login
复杂点在于：同一个 Harbor 地址，在 IDE 里拉镜像、在终端跑 docker build、在 CI 里跑 buildx，三者认证机制完全独立。别指望配一次就全通——每个执行主体都要单独搞定凭据落地。
