1. IronOCR
  2. 故障排除
  3. libgdiplus

将 libgdiplus 与 IronOCR 结合使用：设置指南

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

.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,请阅读我们的.NET 6 版 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-dev
# Update package lists and install necessary libraries
sudo apt-get update && sudo apt-get install -y apt-utils libgdiplus libc6-dev
SHELL

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-dev

macOS

如果您在 macOS 上遇到以下异常：

未处理的异常。 System.DllNotFoundException：无法找到或加载任何名称的本机库：[ libgdiplus, libgdiplus.dylib ]_

您可以通过以下方式解决此问题：

# Update Homebrew and install mono-libgdiplus
brew update && brew install mono-libgdiplus
# Update Homebrew and install mono-libgdiplus
brew update && brew install mono-libgdiplus
SHELL
Curtis Chau
Curtis Chau
  立即与工程团队聊天
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外，Curtis 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 5,167,857 | Version: 2025.11 刚刚发布