1. IronWord
  2. 開始使用
  3. 在 macOS 上使用

在 macOS 上開始使用 IronWord

Kye Stuart
Kye Stuart
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWord 讓 .NET 開發人員能夠在 C# 中讀取、建立及處理 Word 文件，無需安裝 Microsoft Office。 雖然 IronWord 通常用於 Windows 和 Linux 環境，但在正確設定下，它也能在 macOS 上順利運行。

本指南將引導您安裝所需套件，並在 macOS 開發環境中設定 IronWord。

macOS 的先決條件

在 macOS 上開始使用 IronWord 之前，請確保已安裝以下項目：

IronWord 最佳運作環境為 .NET Core LTS 版本或更新版的 .NET SDK。

安裝原生 macOS 依賴項

IronWord 依賴 libgdiplus 來執行圖形操作，例如渲染和處理 DOCX 內容。

您可以使用 Homebrew 安裝此依賴項：

brew install mono-libgdiplus

這將安裝所需的原生影像渲染函式庫。 若您遇到與 System.Drawing.Common 相關的錯誤，這通常是因缺少此依賴項所致。

NuGet 套件安裝

IronWord 同時支援 Apple Silicon 和 Intel 架構的 Mac 電腦。 我們建議大多數使用者選用標準的 IronWord 套件。

Install-Package IronWord

與 macOS ARM 的相容性

IronWord 完全相容於 Apple Silicon 晶片。 使用 M1 或 M2 機型的開發人員可採用相同的 IronWord NuGet 套件及設定說明。

若您使用 Visual Studio for Mac 或 JetBrains Rider，請確保目標平台為 .NET 6 或更高版本，以獲得最佳相容性。

常見問題

在 macOS 上使用 IronWord 的先決條件是什麼？

若要在 macOS 上使用 IronWord，請確保已安裝 .NET 6 或 .NET 7 SDK、Homebrew，以及 macOS 11 (Big Sur) 或更新版本。IronWord 同時相容於 Apple Silicon 和 Intel 架構的 Mac 電腦。

如何在 macOS 上安裝 IronWord 所需的依賴項？

您可以透過 Homebrew 執行命令 'brew install mono-libgdiplus' 來安裝所需的原生依賴項 libgdiplus。這有助於執行渲染和處理 DOCX 內容等圖形操作。

IronWord 是否相容於 Apple Silicon 晶片？

是的，IronWord 完全相容於 Apple Silicon 晶片，例如 M1 和 M2 裝置所搭載的晶片。您可以使用與 Intel Mac 相同的 IronWord NuGet 套件及設定說明。

若遇到與 System.Drawing.Common 相關的錯誤，我該怎麼辦？

此類錯誤通常表示缺少依賴項。請確認您已透過 Homebrew 安裝 libgdiplus，因為這是 IronWord 執行圖形化操作所需的元件。

在 macOS 上使用 IronWord 時，建議採用哪些開發環境？

IronWord 可與 Visual Studio for Mac 及 JetBrains Rider 搭配使用。為確保最佳相容性，請確認您的目標平台為 .NET 6 或更高版本。

使用 IronWord 是否需要安裝 Microsoft Office？

不，IronWord 讓您能夠在 C# 中讀取、建立及處理 WORD 文件，無需在系統上安裝 Microsoft Office。

IronWord 能否在 macOS 以外的環境中使用？

是的，雖然本指南主要針對 macOS，但 IronWord 亦設計為可在 Windows 和 Linux 環境中運行。

在 macOS 上，我應該安裝哪個 NuGet 套件來使用 IronWord？

對於大多數使用者，我們建議安裝標準的 IronWord NuGet 套件，該套件同時支援 Apple Silicon 與 Intel 架構的 Mac 電腦。

IronWord 在 macOS 上支援哪些版本的 .NET？

IronWord 最佳相容於 .NET Core LTS 版本或更新的 .NET SDK，以確保最佳效能與相容性。

Kye Stuart
Kye Stuart
  立即與工程團隊聯繫
技術撰稿人

Kye Stuart 在 Iron Software 將編程熱情與寫作技巧完美結合。他們曾於 Yoobee College 修習軟體部署課程，如今專注於將複雜的技術概念轉化為淺顯易懂的教育內容。Kye 重視終身學習，並樂於迎接新的技術挑戰。

工作之餘，他熱衷於 PC 遊戲、在 Twitch 進行直播，以及園藝和遛狗（愛犬名為 Jaiya）等戶外活動。Kye 直率坦誠的作風，使其成為 Iron Software 實現「為全球開發者解構技術神秘面紗」這項使命的關鍵人物。

準備開始了嗎？
Nuget 下載 44,829 | 版本： 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎？

想要快速確認成果嗎？ PM > Install-Package IronWord
執行範例 觀看您的資料轉為 WORD 文件。