Go 的 int 是平台相关原生整型（32 或 64 位），而 C.int 是 CGO 为 C 标准 int 类型生成的独立、不可隐式转换的绑定类型，二者在 Go 类型系统中完全不兼容，必须显式转换且严禁混用指针。
go 的 `int` 是平台相关原生整型（32 或 64 位），而 `c.int` 是 cgo 为 c 标准 `int` 类型生成的独立、不可隐式转换的绑定类型，二者在 go 类型系统中完全不兼容，必须显式转换且严禁混用指针。
在 Go 与 C 互操作（CGO）场景中，int 和 C.int 表面相似，实则存在三重根本性差异：语义来源不同、内存布局可能不同、类型系统严格隔离。理解这三点，是写出健壮、可移植、类型安全 CGO 代码的前提。
一、位宽差异：C int 是“固定语义”，Go int 是“平台适配”
C 标准规定 int 通常为 32 位有符号整数（ISO/IEC 9899:2018 §5.2.4.2.1），该宽度在绝大多数 POSIX 系统（Linux/macOS）及 Windows（MSVC/MinGW）上保持一致。而 Go 的 int 类型设计哲学是“匹配目标平台自然字长”：
- 在 amd64/arm64 等 64 位架构下，int 为 64 位（int64）；
- 在 386/arm（如你使用的 GOARCH=arm）等 32 位架构下，int 为 32 位（int32）。
因此，在你的 GOARCH=arm 环境中，int 与 C.int 虽然恰好同为 32 位，但 Go 编译器仍拒绝隐式转换——因为类型系统不基于大小判断兼容性，而基于类型身份（type identity）。这也是你遇到编译错误的根本原因：
var vGo int var vC C.int C.c_function(&vGo) // ❌ 错误：*int ≠ *C.int —— 类型不匹配 C.c_function(&vC) // ✅ 正确：类型精确匹配
⚠️ 注意：切勿依赖“32 位平台下二者大小相同”而省略转换。一旦代码迁移到 amd64，int 变为 64 位，而 C.int 仍是 32 位，此时不仅类型不兼容，还可能引发截断或未定义行为。
二、类型隔离：每个包的 C.int 都是私有类型
CGO 并非简单地将 C.int 映射为全局类型。实际上，import "C" 会在每个导入它的 Go 包内生成独立的、未导出的底层类型（如 _Ctype_int）。这意味着：
- main.C.int 与 mypkg.C.int 在 Go 类型系统中是完全不同的类型；
- 即使两者都来自同一份 C 头文件，也无法互相赋值或传递指针；
- 若你在 main 包声明 C.int，又试图将其地址传给 mypkg.SomeCFunc(*C.int)，编译器将报错：
cannot use &x (type *_Ctype_int) as type *mypkg._Ctype_int in argument。
✅ 最佳实践：将所有 CGO 交互封装在单一包内
创建专用封装包（如 cbridge），在其中完成全部 C 类型转换，并对外暴露纯 Go 接口：
// cbridge/cbridge.go
package cbridge
/*
#include <mylib.h>
*/
import "C"
import "unsafe"
// 安全封装：隐藏 C.int，只暴露 Go 原生类型
func DoWork(value int) error {
cVal := C.int(value) // 显式转换（自动截断检查由调用方负责）
ret := C.my_c_function(&cVal)
if ret != 0 {
return ... // 错误处理
}
return nil
}// main.go
package main
import "example.com/cbridge"
func main() {
cbridge.DoWork(42) // ✅ 无 C 类型泄漏，类型安全，跨架构稳定
}此模式彻底规避了跨包类型不兼容问题，同时提升可维护性与安全性。
三、正确转换与注意事项
| 场景 | 推荐方式 | 示例 |
|---|---|---|
| int → C.int | 显式类型转换 | cInt := C.int(goInt) |
| C.int → int | 显式类型转换 | goInt := int(cInt) |
| 指针传递 | 必须使用 C.int 变量的地址 | C.func(&cInt)，绝不可 &goInt |
| 边界检查（关键！） | 对可能溢出的值做预检 | if goInt < math.MinInt32 || goInt > math.MaxInt32 { panic("out of C.int range") } |
import (
"math"
"unsafe"
"C"
)
func safeToInt32(v int) (C.int, error) {
if v < math.MinInt32 || v > math.MaxInt32 {
return 0, fmt.Errorf("value %d out of C.int range [%d, %d]",
v, math.MinInt32, math.MaxInt32)
}
return C.int(v), nil
}总结
- C.int 不是 Go 的别名，而是 CGO 为 C int 创建的强类型绑定，与 int 永远不兼容；
- 位宽一致性（如 arm 下均为 32 位）不能替代类型转换，更不保证跨平台安全；
- 所有 CGO 交互应通过封装包隔离，对外仅暴露 Go 原生类型；
- 涉及数值转换时，务必进行显式转换 + 范围校验，避免静默截断。
权威参考：官方文档 cgo 文档 与 C? Go? Cgo! 详细说明了类型映射规则与安全边界。
