C接口 中文字符问题

C接口 中文字符问题

• [1. C接口字符串传递](#1. C接口字符串传递)
• [2. 示例代码](#2. 示例代码)
• • [2.1. 基本C接口字符传递（不支持中文）](#2.1. 基本C接口字符传递（不支持中文）)
  • [2.2. 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，避免编码转换的干扰。