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 與 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 或更高版本。
我需要安裝 Microsoft Office 來使用 IronWord 嗎?
不需要,IronWord 允許您在 C# 中閱讀、創建和操作 Word 文件,而無需在您的系統上安裝 Microsoft Office。
IronWord 可以在 macOS 以外的環境下使用嗎?
可以,儘管該指南專注於 macOS,IronWord 也被設計用於在 Windows 和 Linux 環境中運行。
在 macOS 上我應該安裝哪個 IronWord 的 NuGet 包?
對於大多數用戶,我們建議安裝支持 Apple Silicon 和 Intel Mac 的標準 IronWord NuGet 包。
IronWord 在 macOS 上支持哪些版本的 .NET?
IronWord 最佳支持 .NET Core LTS 版本或更新的 .NET SDK,以確保最佳性能和兼容性。






