潍坊建设网站的公司站长工具站长之家官网
C接口 中文字符问题
- 1. C接口字符串传递
- 2. 示例代码
- 2.1. 基本C接口字符传递（不支持中文）
- 2.2. C接口中文字符传递（支持中文）
1. C接口字符串传递
在使用 C/C++ 编写 DLL 并通过 C# 调用时，常见的跨语言字符串传递方式是通过 const char*。但在涉及中文路径或文件名等含有非 ASCII 字符的情况时，如果编码方式处理不当，可能会出现乱码或崩溃问题。
本篇文章将详细讲解如何通过 const char* 实现 UTF-8 编码的中文字符传递，适配中英文路径，并在 C# 和 C++ 之间安全传参。
主要问题汇总：
| 问题 | 错误做法 | 正确做法 |
|---|---|---|
| 中文乱码 | 直接传 string / char* | 使用 UTF-8 编码 + 手动传递 IntPtr |
| 编码不统一 | 使用默认编码（如 ANSI） | 明确使用 UTF-8 编码 |
| 控制台乱码 | 默认编码输出中文 | 设置 SetConsoleOutputCP(CP_UTF8) |
2. 示例代码
2.1. 基本C接口字符传递（不支持中文）
以char*作为字符串之间的传递
#define DLL_EXPORT __declspec(dllexport)
#define DLL_IMPORT __declspec(dllimport)extern "C" {
DLL_EXPORT int SetFile(const char* filePath) {std::cout << "filePath:" << filePath << std::endl;
}
} // extern "C"
2.2. C接口中文字符传递（支持中文）
为了支持中文字符，我们需要：
- 保证 C# 传入的是 UTF-8 编码的字节流
- 在 C++ 端以 UTF-8 的方式接收和处理
#define DLL_EXPORT __declspec(dllexport)
#define DLL_IMPORT __declspec(dllimport)extern "C" {
DLL_EXPORT int SetFile(const char* filePath) {std::string utf8_path(stpPath);std::cout << "filePath:" << utf8_path<< std::endl;
}
} // extern "C"
C#端调用示例
using System;
using System.Text;
using System.Runtime.InteropServices;class Program
{// 指定调用约定和 ANSI 编码，但我们传入的是 UTF-8 字节，所以用 IntPtr 更安全[DllImport("YourDll.dll", CallingConvention = CallingConvention.Cdecl)]public static extern int SetFile(IntPtr filePath);static void Main(){string filePath = "C:\\测试\\文件.txt";// 编码为 UTF-8 字节数组（带末尾 null 终止符）byte[] utf8Bytes = Encoding.UTF8.GetBytes(filePath + "\0");// 分配非托管内存IntPtr unmanagedPtr = Marshal.AllocHGlobal(utf8Bytes.Length);try{Marshal.Copy(utf8Bytes, 0, unmanagedPtr, utf8Bytes.Length);// 调用 C 接口SetFile(unmanagedPtr);}finally{Marshal.FreeHGlobal(unmanagedPtr); // 释放内存}}
}
✅ 说明：
- 使用 Encoding.UTF8.GetBytes() 确保传入的是 UTF-8 编码。
- 自行添加 \0 终止符，防止 C++ 接口访问越界。
- 使用 IntPtr 而不是 string，避免编码转换的干扰。