Go中导入外部包只需两步:先用go get下载并更新go.mod中的依赖,再在代码中用import声明引用;现代Go项目依赖由模块管理,go build或go run会自动下载所需包。

在 Go 中导入外部包,核心是两步:先用 go get 下载安装,再在代码中用 import 声明引用。但要注意,从 Go 1.18 开始,go get 默认只用于下载并更新 go.mod 中的依赖,不再自动将包安装到 $GOPATH/bin(除非带 -u -v 且目标是可执行命令)。实际开发中,绝大多数情况只需正确写 import 并运行 go build 或 go run,Go 会自动下载依赖。
使用 go get 下载并记录依赖
现代 Go 项目基于模块(module),依赖信息保存在 go.mod 文件中。go get 的主要作用是拉取包、解析版本,并更新 go.mod 和 go.sum:
- 下载最新稳定版:
go get github.com/sirupsen/logrus - 指定版本:
go get github.com/spf13/cobra@v1.8.0 - 降级或修复版本后同步:
go get github.com/gorilla/mux@v1.8.5 - 若项目尚未初始化模块,先运行
go mod init myproject
执行后,Go 会自动添加 require 条目到 go.mod,并生成校验和写入 go.sum。不需要手动“安装”到全局路径。
在代码中正确 import 外部包
import 语句写在文件顶部,必须使用包的完整模块路径(即 go.mod 中声明的 module 名 + 子路径):
立即学习“go语言免费学习笔记(深入)”;
-
标准库直接写包名:
import "fmt" - 第三方包用其模块路径:
import "github.com/sirupsen/logrus" - 可起别名避免冲突:
import log "github.com/sirupsen/logrus" - 匿名导入(仅执行 init):
import _ "net/http/pprof"
注意:import 路径 ≠ GitHub URL 路径。例如 golang.org/x/net/html 对应模块 golang.org/x/net,子包是 html;导入时仍写完整路径 "golang.org/x/net/html"。
常见问题与注意事项
实际操作中容易卡在这几个点:
-
代理问题:国内用户常因网络无法拉取
golang.org域名下的包,可设置代理:go env -w GOPROXY=https://goproxy.cn,direct -
版本不匹配:如果已有旧版本依赖,
go get默认不会升级;加-u参数可升级到最新兼容版:go get -u github.com/go-sql-driver/mysql -
未启用模块模式:在
$GOPATH外运行go get却无go.mod,会报错 “cannot find module providing package”。此时需先go mod init -
误以为要 go install:除非你要把某个 CLI 工具(如
gofmt)装到本地 bin 目录,否则普通库不需要go install。
验证是否成功引入
写一行简单调用,然后运行:
- 新建
main.go,import 并使用该包(如logrus.Info("hello")) - 执行
go run main.go—— 若首次运行,Go 会自动下载依赖并缓存到$GOPATH/pkg/mod - 查看
go.mod是否新增对应 require 行,go.sum是否有哈希记录 - 也可用
go list -m all查看当前所有依赖及其版本
不复杂但容易忽略细节。关键是理解:go get 是“声明我要用这个版本”,import 是“我在代码里用它”,而构建过程自动完成下载与链接。










