# 加載項  xlwings加載項是能夠使用`RunPython`或`UDFs`的首選方式。 請注意，如果您只想通過xlwings從Python操作Excel，則不需要加載項。 >[info]注意 加載項的功能區與Windows上的Excel> = 2007和Mac上的> = 2016兼容。 但是，您可以使用早期版本的加載項，但您需要直接在配置文件中更改設置，請參閱下文。 在Mac上，所有與UDF相關的功能都不可用。 >[info]注意 加載項使用密碼`xlwings`進行密碼保護。 要進行調試或添加新擴展，您需要取消保護。 ## 安裝 要安裝加載項，最簡單的方法是使用命令行客戶端：`xlwings addin install`。 從技術上講，這會將Python的安裝目錄中的加載項復制到Excel的`XLSTART`文件夾中。 如果您遇到問題，那么您也可以從[GitHub發布頁面](https://github.com/ZoomerAnalytics/xlwings/releases)下載加載項（`xlwings.xlam`）（確保下載相同內容） 版本作為Python包的版本）。 下載后，您可以通過轉到`開發工具>加載項>瀏覽`來安裝該加載項。 如果您沒有在功能區中看到`開發工具`作為選項卡，請確保首先在`文件>選項>自定義功能區`（Mac：`Cmd +，>功能區和工具欄`）下激活選項卡。 然后，要在工作簿中使用`RunPython`或`UDFs`，你需要在VBA編輯器中設置對`xlwings`的引用，參見截圖（Windows：`工具> 引用...`，Mac：它在下面 VBA編輯器的左下角）。 請注意，當您通過`xlwings quickstart`創建工作簿時，已經設置了引用。  ## 全局設置 雖然默認設置通常是開箱即用的，但您可以直接在加載項中更改全局設置： * `Interpreter`: 這是Python解釋器的路徑。 這也適用于Mac上的虛擬或conda環境。 如果你在Windows上使用conda envs，那么請使用下面的`Conda Base`和`Conda Env`。 示例：`"C:\Python35\pythonw.exe"`或`"/usr/local/bin/python3.5"`。 一個空字段默認為`pythonw`，它要求在Windows上的`PATH`或Mac上的`.bash_profile`中設置解釋器。 * `PYTHONPATH`: 如果找不到代碼的源文件，請在此處添加路徑。 * `Conda Base`: 如果您使用的是Windows并使用conda env，請在此處鍵入Anaconda或Miniconda安裝的基本名稱，例如： `C:\Users\Username\Miniconda3`或`%USERPROFILE%\Anaconda`。 請注意，您至少需要conda 4.6！ * `Conda Env`: 如果您使用的是Windows并使用conda env，請在此輸入您的conda env的名稱，例如：`myenv`。 請注意，這要求您將`Interpreter`留空或將其設置為`python`或`pythonw`。 * `UDF Modules`: 從中導入UDF的Python模塊的名稱（沒有.py擴展名）。 用";"分隔多個模塊。 示例：`UDF_MODULES ="common_udfs; myproject"`默認導入與Excel電子表格相同的目錄中的文件，該文件具有相同的名稱，但以`.py`結尾。 * `Debug UDFs`: 如果要手動運行xlwings COM服務器進行調試，請選中此框，請參閱[調試](debugging.md)。 * `Log File`: 為默認位置留空（見下文）或提供完整路徑，例如。 * `RunPython: Use UDF Server`: 對于RunPython使用與UDF相同的COM服務器。 這將更快，因為解釋器在每次調用后都不會關閉。 * `Restart UDF Server`: 這會關閉UDF Server / Python解釋器。 它將在下一個函數調用時重新啟動。 >[info]注意 如果你使用`Conda Base`和`Conda Env`和UDF，你當前無法隱藏彈出的命令提示符。 您仍然可以通過分別將`Interpreter`設置為`python`或`pythonw`來控制輸出是否打印到命令提示符。 ## 全局配置：功能區/配置文件 xlwings功能區中的設置存儲在配置文件中，該文件也可以在外部進行操作。 位置是 * Windows: 您的用戶文件夾中的`.xlwings\xlwings.conf` * Mac Excel 2016: `~/Library/Containers/com.microsoft.Excel/Data/xlwings.conf` \# Mac Excel 2011: `~/.xlwings/xlwings.conf` 格式如下（鍵為大寫）： ~~~ "INTERPRETER","pythonw" "PYTHONPATH","" ~~~ >[info]注意 Mac Excel 2011用戶必須在`~/.xlwings/xlwings.conf`下手動創建和編輯配置文件，因為不支持功能區。 ## 工作簿目錄配置：配置文件 通過在工作簿的目錄中創建`xlwings.conf`文件，可以為一個或多個工作簿覆蓋功能區/配置文件的全局設置。 ## 工作簿配置：xlwings.conf工作表 特定于工作簿的設置將覆蓋全局（功能區）和工作簿目錄配置文件：通過在名稱為"xlwings.conf"的工作表中列出配置鍵/值對來設置工作簿特定設置。 當您使用`xlwings quickstart`創建一個新項目時，它已經有了這樣的工作表，但您需要將其重命名為`xlwings.conf`以使其處于活動狀態。  ## 替代方案：獨立VBA模塊 有時，運行xlwings代碼而不必先安裝加載項可能很有用。 為此，在創建新項目時需要使用`standalone`選項：`xlwings quickstart myproject --standalone`。 這會將加載項的內容添加為單個VBA模塊，因此您無需再設置對加載項的引用。 如果不使用名為`xlwings.conf`的工作表覆蓋它們，它仍將從`xlwings.conf`中讀取。 ## 日志文件默認位置 這些日志文件用于錯誤彈出窗口： * Windows: `%APPDATA%\xlwings.log` * Mac with Excel 2011: `/tmp/xlwings.log` * Mac with Excel 2016: `~/Library/Containers/com.microsoft.Excel/Data/xlwings.log`