安装¶

前置条件¶

xlwings（开源版）需要一个Excel 的安装因此仅适用于Windows和macOS请注意，macOS 当前不支持 UDF。
xlwings PRO 提供更多功能：
- 文件读取器（v0.28.0 中新增）：还可在 Linux 上运行，且不需要安装 Excel。
- xlwings 服务器（v0.26.0 中新增）在 Linux 上也可运行，并不要求本地安装 Python。它与 Windows 和 macOS 上的桌面版 Excel、网页版 Excel 和 Google Sheets 兼容。
xlwings 至少需要 Python 3.9。

这是支持旧版 Python 的 xlwings 之前版本：

xlwings 预先安装在

如果您是 Python 新手或在安装 xlwings 时遇到问题，强烈建议使用这些发行版。否则，您也可以通过 pip 安装：

pip install xlwings

或者通过conda：

conda install xlwings

请注意官方 conda 包可能落后几个发布版本。不过您可以使用conda-forge渠道（如果已安装 xlwings，请替换install替换为upgrade）：

conda install -c conda-forge xlwings

要安装插件，请运行以下命令：

xlwings addin install

若要从 Python 自动化 Excel，您不需要插件。另外，您也可以使用单文件 VBA 模块（独立工作簿）代替插件。更多详情请参见插件与设置.

注意

插件需要与 Python 包保持相同版本。请在升级 xlwings 包后再次运行xlwings add install。

注意

如果您在 macOS 上并且使用的是 VBA 独立模块而非插件，则需要运行$ xlwings runpython install一次。

对于自动化 Excel，您需要以下依赖项：

依赖项会通过conda或pip自动安装。如果您想无依赖项安装 xlwings，可以运行pip install xlwings --no-deps.

这些包不是必需的，但非常推荐，因为它们与 xlwings 配合得很好。这些包都已随 Anaconda 预安装。使用 pip 可以这样安装 xlwings 及所有可选依赖项：

pip install "xlwings[all]"

要更新到最新版本的 xlwings，请在命令提示符中运行以下内容：

pip install --upgrade xlwings

或者：

conda update -c conda-forge xlwings

请确保您的 Excel 插件版本与您的 Python 包版本同步，方法是运行以下命令（请确保先关闭 Excel）：

xlwings addin install

注意

如果在更新后遇到 UDF 错误，请通过Object required重新导入函数并重新计算工作簿。Ctrl+Alt+F9.

要完全卸载 xlwings，请先卸载插件，然后使用相同的安装方法（pip 或 conda）卸载 xlwings 包：

xlwings addin remove

然后

pip uninstall xlwings

或者：

conda remove xlwings

最后，如果存在，请手动删除主目录中的.xlwings目录。