Go项目编译报错package foo is not in GOROOT的高效解决方法

核心问题定位 #

报错package foo is not in GOROOT的本质是GOROOT环境变量未正确配置，导致Go无法找到标准库的存储路径；同时Makefile中重复初始化模块的逻辑会干扰依赖管理流程。

1. 修正Go环境变量（~/.bashrc） #

修改~/.bashrc，确保GOROOT指向你的Go实际安装根目录（比如你的Go二进制在~/bin/go，若为标准安装结构，根目录应为~/go，即~/go/bin/go是二进制文件路径），同时明确启用Go Modules：

# 删除原无效的mkdir /usr/local/go命令，替换为以下配置
export GOROOT=~/go  # 替换为你的Go实际安装根目录
export GOPROXY=https://proxy.golang.org
mkdir -p ~/gobin/bin
export GOPATH=~/gobin
export GO111MODULE=on  # 强制启用模块模式，避免GOPATH干扰
export PATH=$GOROOT/bin:$PATH:$GOPATH/bin  # 优先使用正确的Go版本

执行source ~/.bashrc使配置生效。

2. 重构Makefile，优化依赖管理 #

删除每次删除go.mod的冗余逻辑，让依赖管理更高效，同时自动适配系统平台：

# 自动检测当前系统平台
PLATFORM := $(shell uname -s)

GO_SOURCE_FILE=automate_things.go
GO_BINARY_FILE=automate_things
GO_BIN_DIR=bin/

.SILENT: build
.DEFAULT_GOAL := build

build: fmt dep
	# 根据平台编译对应二进制
	ifeq ($(PLATFORM),Linux)
		GOARCH=amd64 GOOS=linux go build -ldflags "-s -w" -o ./$(GO_BINARY_FILE) $(GO_SOURCE_FILE)
	endif
	ifeq ($(PLATFORM),Darwin)
		GOARCH=amd64 GOOS=darwin go build -ldflags "-s -w" -o ./$(GO_BINARY_FILE) $(GO_SOURCE_FILE)
	endif
.PHONY: build

fmt:
	go fmt $(GO_SOURCE_FILE)
.PHONY: fmt

dep:
	# 仅首次初始化模块，后续直接更新依赖
	if [ ! -f go.mod ]; then \
		go mod init automate_things; \
	fi
	go mod tidy  # 自动管理主/子依赖，无需手动罗列
	go mod download
.PHONY: dep

3. 验证修复并重新编译 #

1. 检查环境变量是否正确：

go env GOROOT GOPATH GO111MODULE

确保GOROOT指向正确目录，GO111MODULE值为on。

2. 清理旧依赖缓存（可选，避免残留问题）：

go clean -modcache

3. 执行编译：

make

4. 解决sudo执行go get的问题 #

sudo会加载root的环境变量，导致你的Go配置不生效，如需用sudo执行，需保留当前用户环境：

sudo -E go get github.com/melbahja/goph

注：Go项目依赖管理通常无需sudo，尽量避免使用。

内容的提问来源于stack exchange，提问作者perpetual