当前位置：首页 > news >正文

C#调用C++ DLL实现跨语言开发完整指南

news 2026/7/18 8:40:10

1. 项目概述

最近在开发一个需要同时使用C++高性能计算和C#便捷UI的项目时，遇到了一个典型的技术挑战：如何在C#中调用C++编写的功能模块。经过一番探索，发现通过DLL（动态链接库）实现跨语言调用是最优解决方案。本文将详细介绍如何使用C++创建DLL并在C#中调用的完整流程。

这种技术组合在实际开发中非常常见，比如游戏开发中用C++处理核心算法，用C#开发编辑器工具；或者在工业控制领域用C++处理底层硬件通信，用C#开发上位机界面。掌握这种跨语言调用技术，可以充分发挥两种语言各自的优势。

2. 核心原理与准备工作

2.1 DLL工作原理解析

动态链接库(DLL)是Windows平台上的一种可执行文件格式，它包含可由多个程序同时使用的代码和数据。与静态库不同，DLL在程序运行时才被加载，这种特性使得：

多个应用程序可以共享同一个DLL的单个副本
可以独立更新DLL而无需重新编译主程序
减小了主程序的文件大小

在跨语言调用场景中，DLL充当了"桥梁"的角色。C++将功能封装在DLL中，C#通过平台调用服务(P/Invoke)机制来加载和使用这些功能。

2.2 开发环境配置

要实现C++和C#的互操作，需要准备以下开发环境：

Visual Studio 2022：建议使用Community版，它完全免费且功能齐全
.NET 6.0或更高版本：这是运行C#程序所必需的
C++桌面开发工作负载：在VS安装器中勾选此项

安装完成后，创建一个新的解决方案，我们将在这个解决方案中同时包含C++ DLL项目和C#测试项目。

提示：确保两个项目都使用相同的平台目标（如x64），否则会出现兼容性问题。

3. C++ DLL项目创建与实现

3.1 创建DLL项目

在Visual Studio中：

选择"创建新项目"
搜索"Dynamic-Link Library (DLL)"
命名为"CounterLib"并创建

项目创建后会自动生成几个关键文件：

pch.h/pch.cpp：预编译头文件，加速编译过程
dllmain.cpp：DLL入口点，通常不需要修改
framework.h：项目主头文件

3.2 实现核心功能类

我们以一个简单的计数器为例，首先创建Counter.h头文件：

#pragma once class Counter { private: int value; public: Counter(int value); void Increment(); int GetValue(); };

然后在Counter.cpp中实现：

#include "pch.h" #include "Counter.h" Counter::Counter(int value) { this->value = value; } void Counter::Increment() { this->value += 1; } int Counter::GetValue() { return this->value; }

3.3 创建C风格接口

由于C++有名称修饰(name mangling)机制，直接暴露C++类会给跨语言调用带来困难。我们需要创建C风格的接口：

#include "pch.h" #include "Counter.h" #define API __declspec(dllexport) extern "C" { API Counter* CreateCounter(int value) { return new Counter(value); } API void DisposeCounter(Counter* counter) { delete counter; } API void IncrementCounter(Counter* counter) { counter->Increment(); } API int GetCounterValue(Counter* counter) { return counter->GetValue(); } }

关键点说明：

__declspec(dllexport)：标记函数需要从DLL导出
extern "C"：禁用C++名称修饰，确保函数名保持不变
提供了完整的生命周期管理函数

3.4 配置与生成DLL

在项目属性中：

配置类型设置为"Dynamic Library (.dll)"
平台工具集选择与C#项目匹配的版本
输出目录设置为解决方案的bin文件夹

生成项目后，会在bin目录下得到CounterLib.dll和CounterLib.lib文件。

4. C#调用DLL的实现

4.1 创建C#测试项目

在同一个解决方案中添加一个新的"xUnit测试项目"，命名为"CounterTest"。配置项目属性：

<PropertyGroup> <OutputPath>$(SolutionDir)Bin\</OutputPath> <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath> </PropertyGroup>

这样C#项目的输出也会到bin目录，确保DLL文件能被正确找到。

4.2 实现DLL包装类

创建一个CounterWrapper类来封装原生DLL调用：

using System; using System.Runtime.InteropServices; internal class CounterWrapper : IDisposable { private const string COUNTER_LIB_DLL_PATH = "CounterLib.dll"; [DllImport(COUNTER_LIB_DLL_PATH, CallingConvention = CallingConvention.Cdecl)] private static extern IntPtr CreateCounter(int value); [DllImport(COUNTER_LIB_DLL_PATH, CallingConvention = CallingConvention.Cdecl)] private static extern void DisposeCounter(IntPtr counterPointer); [DllImport(COUNTER_LIB_DLL_PATH, CallingConvention = CallingConvention.Cdecl)] public static extern void IncrementCounter(IntPtr counterPointer); [DllImport(COUNTER_LIB_DLL_PATH, CallingConvention = CallingConvention.Cdecl)] private static extern int GetCounterValue(IntPtr counterPointer); private IntPtr _counterPointer; public CounterWrapper(int initialValue) { _counterPointer = CreateCounter(initialValue); if (_counterPointer == IntPtr.Zero) { throw new InvalidOperationException("Failed to create counter."); } } public int GetValue() => GetCounterValue(_counterPointer); public void Increment() => IncrementCounter(_counterPointer); public void Dispose() { DisposeCounter(_counterPointer); GC.SuppressFinalize(this); } ~CounterWrapper() => Dispose(); }

关键点说明：

DllImport属性指定DLL路径和调用约定
IntPtr用于保存原生指针
实现了IDisposable确保资源释放
添加了终结器作为最后保障

4.3 编写测试用例

使用xUnit编写测试验证功能：

public class CounterLibTest { [Fact] public void Counter_ShouldIncrementCorrectly() { // Arrange int initialValue = 5; int increments = 3; int expected = initialValue + increments; // Act using (var counter = new CounterWrapper(initialValue)) { for (int i = 0; i < increments; i++) { counter.Increment(); } // Assert Assert.Equal(expected, counter.GetValue()); } } }

使用using语句确保资源及时释放，测试通过说明跨语言调用成功。

5. 高级主题与问题排查

5.1 数据类型映射

C++和C#的数据类型需要正确对应，常见映射关系：

C++ 类型	C# 类型	说明
int	int	32位整数
float	float	单精度浮点数
double	double	双精度浮点数
char*	string或IntPtr	字符串需要特殊处理
bool	bool	布尔值
struct	struct	需要完全匹配内存布局

对于复杂类型如结构体，需要在C#中使用[StructLayout(LayoutKind.Sequential)]确保内存布局一致。

5.2 常见问题与解决方案

DLLNotFoundException
- 确保DLL在输出目录
- 检查平台目标一致性(x86/x64)
- 使用Dependency Walker检查依赖
EntryPointNotFoundException
- 确认函数名完全一致
- 检查调用约定(Cdecl/StdCall)
- 使用dumpbin /exports查看导出函数
内存访问冲突
- 确保指针有效性
- 实现正确的资源释放
- 考虑使用SafeHandle包装原生资源
性能优化技巧
- 减少跨语言调用次数
- 批量处理数据
- 考虑使用C++/CLI作为中间层