设置 .NET 开发环境

要将 MATLAB^® 代码集成到 .NET 应用程序中，请首先使用 MATLAB 桌面编写您的 MATLAB 代码。然后，利用 MATLAB Compiler SDK™ 生成 .NET 组件。最后，在您首选的 C# 开发环境（包括 Windows^® 和 macOS 上的文本编辑器以及 .NET SDK 命令行 API 或 Microsoft^® Visual Studio^®）中完成集成过程。

您需要在设置中包含的文件取决于您使用的是现代版 MATLAB Data API for .NET 还是旧版 MWArray API。

.NET 命令行 API

使用 .NET SDK 命令行界面 (CLI) 和代码编辑器将 MATLAB 代码集成到 .NET 应用程序中。您必须使用 .NET 6.0 或更高版本。您可以在系统命令提示符下键入 dotnet --info 来验证是否已安装 .NET 6.0。有关详细信息，请参阅 .NET CLI 概述。

MATLAB Data API for .NET

将以下程序集依赖项添加到您的工程中：

MathWorks.MATLAB.Runtime.dll
MathWorks.MATLAB.Types.dll

MathWorks 程序集的 Windows 路径

指向 MathWorks 程序集的 Linux 和 macOS 路径

编辑工程文件 (.csproj) 并使用 <ItemGroup> 标记添加上述引用。例如：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net5.0</TargetFramework>
  </PropertyGroup>
  
  <ItemGroup>
    <Reference Include="MathWorks.MATLAB.Runtime">
      <HintPath>C:\Program Files\MATLAB\MATLAB Runtime\R2026a\extern\dotnet\netstandard2.0\MathWorks.MATLAB.Runtime.dll</HintPath>
    </Reference>
    <Reference Include="MathWorks.MATLAB.Types">
      <HintPath>C:\Program Files\MATLAB\MATLAB Runtime\R2026a\extern\dotnet\netstandard2.0\MathWorks.MATLAB.Types.dll</HintPath>
    </Reference>
  </ItemGroup>
</Project>

MWArray API

将以下程序集依赖项添加到您的工程中：

MWArray.dll

指向 MWArray 程序集的 Windows 路径

Microsoft Visual Studio

如果您使用 Visual Studio 进行集成，请首先验证您是否已安装 Microsoft Visual Studio 2022（v17.0 或更高版本）。

MATLAB Data API for .NET

从 Solution Explorer 中添加上面列出的 MathWorks^® 程序集：

在 Solution Explorer 中，右键点击 Dependencies 节点，然后选择 Add Project Reference。
在 Reference Manager 中浏览并添加上述 MathWorks 程序集依赖项。

设置 PATH 环境变量以配置运行时库的本地库访问

在 Visual Studio 中执行 C# 应用程序之前，请确保正确设置 PATH 环境变量以引用 MATLAB 或 MATLAB Runtime 安装。以下是在 Visual Studio 中设置 PATH 环境变量的方法：

在 Visual Studio 中，右键点击 Solution Explorer 中的工程，然后点击 Properties。
导航到 Debug > General，然后选择 Open debug launch profiles UI。

在 Launch Profiles 窗口的 Environment variables 下，设置您的 PATH：

对于 MATLAB：

PATH=C:\Program Files\MATLAB\R2026a\runtime\win64

对于 MATLAB Runtime：

PATH=C:\Program Files\MATLAB\MATLAB Runtime\R2026a\runtime\win64

MWArray API

从以下位置之一添加 MWArray.dll 程序集作为引用。

指向 MWArray 程序集的 Windows 路径

配置运行时库的本地库访问

注意

如果您使用的是 Microsoft Visual Studio，请参阅上文关于如何设置 PATH 环境变量以配置运行时库的本地库访问权限的部分。

要运行使用由 MATLAB Compiler SDK 生成的组件的 .NET 应用程序，.NET 运行时必须能够定位包含在 MATLAB 或 MATLAB Runtime 中的本机库。这些是特定于平台的文件（.dll、.so 或 .dylib），用于加载和执行打包的 MATLAB 代码。

要使这些库可用，请通过修改相应的环境变量来更新操作系统的原生库搜索路径。

平台	环境变量
Windows	`PATH`
Linux^®	`LD_LIBRARY_PATH`
macOS	`DYLD_LIBRARY_PATH`

有关详细信息，请参阅设置 MATLAB 库路径以测试已部署的应用程序。

小心

在安装了完整 MATLAB 版本的计算机上测试应用程序时，您可以使用 MATLAB 安装来配置对原生库的访问。

在使用 MATLAB Runtime 的部署场景中，您必须在 MATLAB Runtime 的安装目录中明确指定本机库的位置。这种区分确保了已部署的应用程序能够独立于完整的 MATLAB 安装环境运行。

另请参阅

主题

外部网站

https://dotnet.microsoft.com/download