System.Drawing.Common 的替代方案（.NET 7 及非 Windows 環境）

Curtis Chau

Updated: 2026年4月22日

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # System.Drawing.Common 的替代方案（.NET 7 及非 Windows 環境） 自 .NET 6 起，Microsoft 已停止在 Linux 和 macOS 上支援 System.Drawing.Common。 此函式庫現僅支援 Windows 系統。 更多詳細資訊，請參閱[官方文件](https://docs.microsoft.com/en-us/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only)。 ## 解決"System.Drawing.Common 無法在此平台上使用"錯誤的替代方案 ### .NET 6 在非 Windows 作業系統上，會拋出 `TypeInitializationException` 異常，並以 `PlatformNotSupportedException` 作為內部異常。 平台分析器會針對非 Windows 平台發出編譯時警告。 除非您設定了配置選項，否則系統會拋出以下執行時例外： ``` System.TypeInitializationException：'Gdip' 的類型初始化程式拋出了例外。 ---- System.PlatformNotSupportedException : System.Drawing.Common 在非 Windows 平台上不受支援。 ``` #### .NET 6 中的臨時解決方案： 請在 `runtimeconfig.json` 檔案中，將 `System.Drawing.EnableUnixSupport` 執行階段設定開關設為 `true`，以啟用對非 Windows 平台的支援： ```json { "runtimeOptions": { "configProperties": { "System.Drawing.EnableUnixSupport": true } } } ``` 此外，請在程式碼開頭加入以下這行，以透過程式化方式啟用此設定： ```csharp // Enable System.Drawing.Common support on non-Windows platforms in .NET 6 System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true); ``` ### .NET 7 及以上版本 自 .NET 7 起，微軟已完全移除了 Linux 和 macOS 平台上對 `System.Drawing.Common` 的支援，包括先前可用的替代方案。 Iron Software 已發布一款名為 `IronSoftware.Drawing` 的 System.Drawing.Common 開源替代方案。 - [NuGet 套件](https://www.nuget.org/packages/IronSoftware.System.Drawing) - [GitHub 儲存庫](https://github.com/iron-software/IronSoftware.System.Drawing) 如需進一步了解，請參閱[官方文件](https://ironsoftware.com/open-source/csharp/drawing/docs/)。

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

自 .NET 6 起，Microsoft 已停止在 Linux 和 macOS 上支援 System.Drawing.Common。 此函式庫現僅支援 Windows 系統。 更多詳細資訊，請參閱官方文件。

解決"System.Drawing.Common 無法在此平台上使用"錯誤的替代方案

.NET 6

在非 Windows 作業系統上，會拋出 TypeInitializationException 異常，並以 PlatformNotSupportedException 作為內部異常。 平台分析器會針對非 Windows 平台發出編譯時警告。 除非您設定了配置選項，否則系統會拋出以下執行時例外：

System.TypeInitializationException：'Gdip' 的類型初始化程式拋出了例外。

    ---- System.PlatformNotSupportedException : System.Drawing.Common 在非 Windows 平台上不受支援。

System.TypeInitializationException：'Gdip' 的類型初始化程式拋出了例外。

    ---- System.PlatformNotSupportedException : System.Drawing.Common 在非 Windows 平台上不受支援。

.NET 6 中的臨時解決方案：

請在 runtimeconfig.json 檔案中，將 System.Drawing.EnableUnixSupport 執行階段設定開關設為 true，以啟用對非 Windows 平台的支援：

{
    "runtimeOptions": {
        "configProperties": {
            "System.Drawing.EnableUnixSupport": true
        }
    }
}

{
    "runtimeOptions": {
        "configProperties": {
            "System.Drawing.EnableUnixSupport": true
        }
    }
}

此外，請在程式碼開頭加入以下這行，以透過程式化方式啟用此設定：

// Enable System.Drawing.Common support on non-Windows platforms in .NET 6
System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);

// Enable System.Drawing.Common support on non-Windows platforms in .NET 6
System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", true);

' Enable System.Drawing.Common support on non-Windows platforms in .NET 6
System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", True)

' Enable System.Drawing.Common support on non-Windows platforms in .NET 6
System.AppContext.SetSwitch("System.Drawing.EnableUnixSupport", True)

.NET 7 及以上版本

自 .NET 7 起，微軟已完全移除了 Linux 和 macOS 平台上對 System.Drawing.Common 的支援，包括先前可用的替代方案。

Iron Software 已發布一款名為 IronSoftware.Drawing 的 System.Drawing.Common 開源替代方案。

• NuGet 套件
• GitHub 儲存庫

如需進一步了解，請參閱官方文件。

Curtis Chau

立即與工程團隊聊天

技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

...

閱讀更多