在Windows系统中进行Golang开发时,若项目涉及cgo编程、需要编译包含C语言代码的依赖库,就必须安装gcc工具链。Windows平台本身不自带gcc环境,因此需要借助第三方工具完成部署。

选择适合的gcc工具链版本
Windows平台常用的gcc工具链方案有两种,分别是MinGW和MinGW-w64,两者区别如下:
| 工具名称 | 支持架构 | 适用场景 |
|---|---|---|
| MinGW | 仅32位 | 老旧32位系统或仅需要编译32位程序 |
| MinGW-w64 | 32位、64位 | 主流Windows系统,支持编译多架构程序,适配大部分Golang开发需求 |
目前推荐使用MinGW-w64,能够覆盖绝大多数开发场景,下载时可以优先选择离线安装包,避免在线安装过程中出现网络问题。
安装MinGW-w64工具链
下载安装包
访问MinGW-w64的官方发布页面,选择对应版本的离线安装包,比如选择x86_64-posix-seh版本,该版本适配64位Windows系统,兼容性较好。
执行安装步骤
- 双击下载好的安装包,打开安装向导,点击下一步
- 选择安装路径,建议路径不要包含中文和空格,比如设置为
D:mingw-w64 - 选择架构为x86_64,线程模型选择posix,异常处理选择seh,其余选项保持默认即可
- 点击下一步等待安装完成,整个过程大约需要几分钟
配置系统环境变量
安装完成后需要将gcc的可执行文件路径添加到系统环境变量中,具体操作如下:
- 右键点击此电脑,选择属性,进入高级系统设置
- 点击环境变量按钮,在系统变量中找到Path变量,点击编辑
- 点击新建,添加MinGW-w64的bin目录路径,比如
D:mingw-w64bin - 依次点击确定保存所有设置
验证gcc安装是否成功
打开Windows命令提示符或者PowerShell,执行以下命令验证gcc是否安装成功:
gcc --version
如果命令执行后输出gcc的版本信息,说明gcc工具链已经安装成功,接下来就可以在Golang项目中使用。
Golang中使用gcc的注意事项
在Golang项目中启用cgo时需要保证gcc环境可用,编写包含cgo的代码时需要注意以下几点:
- 代码中需要导入
C包,并且cgo的注释需要紧挨着导入语句 - 编译时不需要额外添加特殊参数,只要gcc在环境变量中,Go编译器会自动调用gcc完成C代码的编译
以下是一个简单的cgo示例代码:
package main
// #include <stdio.h>
// void hello() {
// printf("Hello from Cn");
// }
import "C"
func main() {
C.hello()
}
使用go run命令运行该代码,如果能正常输出Hello from C,说明Golang已经可以正常调用gcc工具链完成编译工作。
常见问题排查
- 如果执行
gcc --version提示命令不存在,检查环境变量是否配置正确,或者重启命令行工具后再尝试 - 如果Golang编译时提示找不到gcc,检查MinGW-w64的bin目录下是否存在gcc.exe文件,确认安装路径没有错误
- 如果编译cgo代码时报架构不匹配错误,确认安装的MinGW-w64架构和当前系统架构一致