将 libgdiplus 与 IronOCR 结合使用：设置指南
Curtis Chau
Updated: 2026年6月29日
.NET Core 需要libgdiplus来使用 Microsoft System.Drawing.Common NuGet 包。 如果在 macOS 或 Linux 系统上找不到该组件，您可能会遇到以下异常：
- 未处理的异常。 System.DllNotFoundException：无法找到或加载任何名称的本机库：[ libgdiplus, libgdiplus.so ]_
- 如果您看到
System.TypeInitializationException: The type initializer for 'Gdip' threw an exception,请阅读我们的在 NET6 中的 System.Drawing.Common指南。
Linux
Ubuntu、Debian
要在 Ubuntu 或 Debian 上安装所需的库，请运行以下命令：
# Update package lists and install necessary libraries
sudo apt-get update && sudo apt-get install -y apt-utils libgdiplus libc6-devSHELL
Docker
在您的 Dockerfile 中添加以下行，以确保必要的库包含在您的 Docker 镜像中：
# Update package lists and install necessary libraries in Docker container
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-devText
macOS
如果您在 macOS 上遇到以下异常：
未处理的异常。 System.DllNotFoundException：无法找到或加载任何名称的本机库：[ libgdiplus, libgdiplus.dylib ]_
您可以通过以下方式解决此问题：
- 将runtime.osx.10.10-x64.CoreCompat.System.Drawing NuGet 包添加到您的 .NET 解决方案中，以便在您的项目中包含libgdiplus 。 或者，您也可以使用以下命令通过 Homebrew 手动安装该库：
# Update Homebrew and install mono-libgdiplus
brew update && brew install mono-libgdiplusSHELL
- 更多信息请参阅官方.NET 文档。
技术作家
Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。
...
阅读更多
