CGO 中 LPCWSTR 与 Go 字符串的双向转换详解-Golang-PHP中文网

CGO 中 LPCWSTR 与 Go 字符串的双向转换详解

本文详细讲解在 cgo 环境下如何安全、高效地实现 windows 宽字符字符串（lpcwstr）与 go string 的双向转换，涵盖内存管理、utf-16 编解码及常见陷阱规避。

本文详细讲解在 cgo 环境下如何安全、高效地实现 windows 宽字符字符串（lpcwstr）与 go string 的双向转换，涵盖内存管理、utf-16 编解码及常见陷阱规避。

在 Windows 平台的 CGO 开发中，许多原生 API（如 Win32、COM 或某些 C++ 库封装）使用 LPCWSTR（即 const wchar_t*，等价于 *uint16）作为宽字符串类型。而 Go 原生字符串是 UTF-8 编码的 []byte 抽象，二者编码和内存布局不同，不能直接通过 C.GoString 或 C.CString 转换——这些函数仅适用于 char*（即 *C.char）类型的 C 字符串。

✅ 从 C.LPCWSTR 转换为 Go string

LPCWSTR 指向以 0x0000 结尾的 UTF-16LE 编码的 uint16 序列。转换需分三步：

将 C.LPCWSTR 转为 []uint16 切片（需已知长度或手动遍历找终止符）；
使用 golang.org/x/text/unicode/utf16 包解码为 Unicode 码点（[]rune）；
转为 Go 字符串。

推荐显式传入长度（避免空字符扫描开销），示例：

import (
    "unsafe"
    "golang.org/x/text/unicode/utf16"
)

// 假设已知字符串长度 sz（不含结尾 null）
func WstrToString(wstr *uint16, sz int) string {
    if wstr == nil || sz <blockquote><p>⚠️ 注意：(*[1</p></blockquote><h3>✅ 从 Go string 转换为 C.LPCWSTR</h3><p>Go 字符串需先转为 UTF-16LE 编码的 []uint16，再在 <strong>C 堆上分配内存</strong>（关键！Go 的 GC 不管理 C 内存，且 Go 切片可能被移动），最后返回 C.LPCWSTR。务必手动释放内存（通常由调用方负责）：</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/ai/2249" title="超级简历WonderCV"><img
														src="https://img.php.cn/upload/ai_manual/000/000/000/175679998691134.png" alt="超级简历WonderCV" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/ai/2249" title="超级简历WonderCV" class="overflowclass">超级简历WonderCV</a>
													<p class="overflowclass">一款AI办公效率工具，主要用于免费求职简历模版下载制作，应届生职场人必备简历制作神器，适合需要提升相关任务效率的用户。</p>
												</div>
												<a rel="nofollow" href="/ai/2249" title="超级简历WonderCV" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><pre class="brush:php;toolbar:false;">/*
#cgo LDFLAGS: -lmsvcrt
#include <stdlib.h>
*/
import "C"

func StringToWstr(s string) C.LPCWSTR {
    if s == "" {
        // 返回空指针或指向单个 \0 的静态缓冲区（根据 API 要求选择）
        return nil
    }
    runes := []rune(s)
    wstr := utf16.Encode(runes)

    // 分配 C 堆内存：len+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 <blockquote><p>✅ 最佳实践：封装一个带 defer 清理的辅助函数，或在 Go 层统一封装资源生命周期（如使用 runtime.SetFinalizer，但需谨慎——C 内存释放时机不可控，<strong>强烈建议显式调用 C.free</strong>）。</p></blockquote>
<h3>? 替代方案：借助 C 层辅助函数（更安全）</h3>
<p>若允许扩展 C 代码，可定义轻量级包装函数，利用 Windows API（如 MultiByteToWideChar）或 CRT 函数，避免 Go 层处理裸指针：</p>
<pre class="brush:php;toolbar:false;">// wrapper.c
#include <stdlib.h>
#include <string.h>
#include <windows.h>

// Go 可调用：分配并转换 UTF-8 字符串为 LPWSTR
LPWSTR GoStringToWstr(const char* s) {
    if (!s) return NULL;
    int len = MultiByteToWideChar(CP_UTF8, 0, s, -1, NULL, 0);
    LPWSTR w = (LPWSTR)malloc(len * sizeof(WCHAR));
    MultiByteToWideChar(CP_UTF8, 0, s, -1, w, len);
    return w;
}

void FreeWstr(LPWSTR w) {
    free(w);
}</windows.h></string.h></stdlib.h>

对应 Go 调用：

/*
#cgo LDFLAGS: -luser32
#include "wrapper.c"
*/
import "C"
import "unsafe"

func GoStringToWstr(s string) C.LPCWSTR {
    cstr := C.CString(s)
    defer C.free(unsafe.Pointer(cstr))
    return C.GoStringToWstr(cstr)
}

// 使用后必须显式释放
// ptr := GoStringToWstr("hello")
// defer C.FreeWstr((*C.WCHAR)(unsafe.Pointer(ptr)))

该方式将内存管理和编码逻辑移至 C 层，降低 Go 侧 unsafe 风险，适合长期维护项目。