在 CGO 中调用 Windows API 或使用 Unicode 字符串接口时，需在 C.LPCWSTR（宽字符指针）与 Go 的 string 类型间进行高效、内存安全的双向转换；核心是利用 unicode/utf16 包配合 unsafe 操作，避免数据截断或编码错误。
在 cgo 中调用 windows api 或使用 unicode 字符串接口时，需在 `c.lpcwstr`（宽字符指针）与 go 的 `string` 类型间进行高效、内存安全的双向转换；核心是利用 `unicode/utf16` 包配合 `unsafe` 操作，避免数据截断或编码错误。
Windows 平台 C 接口广泛使用 LPCWSTR（即 const wchar_t*），其底层为 UTF-16 编码的零终止宽字符序列。Go 字符串默认为 UTF-8，因此直接转换需显式处理编码差异。关键原则是：从 C → Go 时需显式读取长度（或查找 null 终止符），从 Go → C 时必须在 C 堆上分配并零初始化内存，避免悬空指针和 GC 干扰。
✅ C.LPCWSTR → string（安全读取）
若已知字符串长度 sz（不含终止符），推荐如下方式：
import (
"unsafe"
"golang.org/x/text/encoding/unicode"
"golang.org/x/text/transform"
"unicode/utf16"
)
// 假设 cPtr 是 C.LPCWSTR，sz 是字符数（非字节数）
wstr := (*[1<<30 - 1]uint16)(unsafe.Pointer(cPtr))[:sz:sz]
runes := utf16.Decode(wstr)
goStr := string(runes)⚠️ 注意事项：
- 不要依赖 \0 自动截断：C.GoString 仅适用于 char*（UTF-8），对 LPCWSTR 无效；
- 若长度未知，需手动查找首个 0 元素（但存在性能开销）：
sz := 0 for ; *(*uint16)(unsafe.Pointer(uintptr(unsafe.Pointer(cPtr)) + uintptr(sz)*2)) != 0; sz++ { }
✅ string → C.LPCWSTR（C 堆分配，自动管理）
Go 字符串不可直接传入 C 函数——因 GC 可能移动底层数组，且 C 侧需持久化内存。正确做法是在 C 堆中分配并拷贝 UTF-16 数据：
/*
#cgo LDFLAGS: -lkernel32
#include <stdlib.h>
#include <stdint.h>
*/
import "C"
import (
"unsafe"
"unicode/utf16"
)
func StringToLPCWSTR(s string) C.LPCWSTR {
runes := []rune(s)
wstr := utf16.Encode(runes)
// 分配 len(wstr)+1 个 uint16（+1 用于 '\0' 终止符）
p := C.calloc(C.size_t(len(wstr)+1), C.sizeof_uint16_t)
if p == nil {
panic("failed to allocate memory for LPCWSTR")
}
// 安全拷贝并添加终止符
dst := (*[1<<30]uint16)(p)[:len(wstr)+1:len(wstr)+1]
copy(dst, wstr)
dst[len(wstr)] = 0 // 显式置零终止
return C.LPCWSTR(p)
}
// 使用后务必释放内存（通常在 C 函数返回后调用）
func FreeLPCWSTR(p C.LPCWSTR) {
C.free(unsafe.Pointer(p))
}✅ 示例调用：
cStr := StringToLPCWSTR("Hello 世界")
defer FreeLPCWSTR(cStr) // 确保释放
// 传递 cStr 给 Windows API，如 MessageBoxW(...)? 替代方案：借助 C 层封装（更稳健）
可在 /* ... */ 中定义轻量 C 辅助函数，复用标准 CRT 或 Windows API：
// 在 CGO 注释块内
#include <windows.h>
#include <stdlib.h>
// 将 UTF-8 字符串转为堆分配的 LPWSTR
LPWSTR GoStringToLPCWSTR(const char* utf8) {
int len = MultiByteToWideChar(CP_UTF8, 0, utf8, -1, NULL, 0);
LPWSTR wstr = (LPWSTR)malloc(len * sizeof(WCHAR));
MultiByteToWideChar(CP_UTF8, 0, utf8, -1, wstr, len);
return wstr;
}
// 释放 LPWSTR
void FreeGoLPCWSTR(LPWSTR p) { free(p); }对应 Go 调用：
cStr := C.GoStringToLPCWSTR(C.CString("Hello 世界"))
defer C.FreeGoLPCWSTR(cStr)此方式由 Windows 系统 API 处理编码转换，兼容性更高，且自动处理代理对（surrogate pairs）。
? 总结建议
- 优先使用 utf16.Decode/Encode + C.calloc/free：纯 Go 实现，无平台依赖；
- 始终显式管理内存生命周期：C 分配 → C 释放，避免内存泄漏；
- 禁止将 &[]uint16[0] 地址传给 C：Go slice 底层可能被 GC 移动；
- 生产环境建议封装为 type LPCWSTR C.LPCWSTR 并实现 String() 和 Free() 方法，提升类型安全与可维护性。
掌握这些模式后，即可在 CGO 项目中稳定、高效地桥接 Windows Unicode 字符串生态。
