Supported Platforms

xlwings requires an installation of Excel and therefore only works on Windows and macOS. Note that macOS currently does not support UDFs.


安裝 xlwings 最簡單的方式是透過 pip:

pip install xlwings

或是 conda:

conda install xlwings

注意 conda 官方的 xlwings 版本可能不是最新版本。 但是,你可以使用 conda-forge 安裝 (請參考: 通常應該都是最新版本(但是仍然有可能比 pip 發佈的速度晚一兩天)):

conda install -c conda-forge xlwings


當你使用 Mac 版的 Excel 2016 並且使用 conda 安裝 xlwings 時(或者使用 Anaconda 提供的版本時),你需要在終端機執行 $ xlwings runpython install 來開啓 VBA 的 RunPython 功能。或者,你可以直接利用 pip 安裝 xlwings。


  • Windows: pywin32, comtypes

    在 Windows 作業系統下,若是使用 condapip, xlwings 的相依套件都會被自動安裝

  • Mac: psutil, appscript

    On Mac, the dependencies are automatically being handled if xlwings is installed with conda or pip. However, with pip, the Xcode command line tools need to be available. Mac OS X 10.4 (Tiger) or later is required. The recommended Python distribution for Mac is Anaconda. With conda on the other hand, you’ll need to manually run the command xlwings runpython install.


  • NumPy
  • Pandas
  • Matplotlib
  • Pillow/PIL
  • Flask (for REST API only)

這些套件雖然不是必須安裝的套件,但是 xlwings 與它們的整合度極高,因此建議安裝。


安裝增益集的流程請參考 Add-in

支援的 Python 版本

xlwings CE requires at least Python 3.5. Python 2.7 is only supported with xlwings PRO.