macOS 版 IronWord 入門指南
IronWord 允許 .NET 開發人員在 C# 中讀取、建立和操作 Word 文檔,而無需安裝 Microsoft Office。 雖然 IronWord 通常用於 Windows 和 Linux 環境,但透過正確的設置,它在 macOS 上也能很好地運作。
本指南將引導您完成依賴項的安裝,並使 IronWord 在您的 macOS 開發環境中運作。
macOS 的先決條件
在 macOS 上開始使用 IronWord 之前,請確保已安裝以下軟體:
- .NET 6 或 .NET 7 SDK
- Homebrew (macOS 軟體包管理器)
- macOS 11(Big Sur)或更高版本(支援 Apple Silicon 和 Intel)
IronWord 與 .NET Core LTS 版本或更高版本的 .NET SDK 搭配使用效果最佳。
安裝 macOS 原生依賴項
IronWord 依賴 libgdiplus 進行圖形操作,例如渲染和處理 DOCX 內容。
您可以使用 Homebrew 安裝此依賴項:
brew install mono-libgdiplus這將安裝所需的本地圖像渲染庫。 如果出現與 System.Drawing.Common 相關的錯誤,通常是因為缺少依賴項造成的。
NuGet 套件安裝
IronWord 既可在 Apple Silicon Mac 上運行,也可在 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 是否相容於蘋果自研晶片?
是的,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上使用IronWord時,我應該安裝哪個NuGet套件?
對於大多數用戶,我們建議安裝標準的 IronWord NuGet 套件,該套件同時支援 Apple Silicon 和 Intel Mac。
IronWord 在 macOS 上支援哪些 .NET 版本?
IronWord 與 .NET Core LTS 版本或更高版本的 .NET SDK 搭配使用效果最佳,可確保最佳效能和相容性。






