# 加载项
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`
