xlwings中文官方文档

xlwings - Make Excel Fly!

发布 dev

Zoomer Analytics LLC

2021 年 10 月 29 日

Getting Started

1 视频教程 1

2 安装 3

2.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2.2 安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

3 快速入门 7

3.1 1. Interacting with Excel from a Jupyter notebook . . . . . . . . . . . . . . . . . . . . . . . 7

3.2 2. Scripting: Automate/interact with Excel from Python . . . . . . . . . . . . . . . . . . . . 7

3.3 3. Macros: Call Python from Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3.4 4. UDFs: User Defined Functions (Windows only) . . . . . . . . . . . . . . . . . . . . . . . 9

4 连接到 Excel 工作簿 11

4.1 Python

到

Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4.2 Excel 到 Python(RunPython) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.3 用户定义函数 (UDFs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

5.6 对象层次结构 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

6 数据结构教程 17

6.1 单个单元格 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

6.2 列表 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

6.3 区域扩展 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

6.4 NumPy 数组 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

6.5 Pandas 数据表 (DataFrame) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

6.6 Pandas 的序列 (Serie) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

6.7 Chunking: Read/Write big DataFrames etc. . . . . . . . . . . . . . . . . . . . . . . . . . . 21

7.6 工作簿目录级配置：配置文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

7.7 工作簿级配置：xlwings.conf 表 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

7.8 可选方式：独立的 VBA 模块 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

8.1 xlwings 加载项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

8.2 用”RunPython”调用 Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

8.3 函数的参数和返回值 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

9.1 Excel 里的一次性准备工作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

9.2 准备工作簿 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

9.9 The “caller”argument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

9.10 “vba”关键字 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

9.11 宏 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

9.12 从 VBA 调用 UDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

9.13 异步 UDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

10.1 Matplotlib . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

10.2 Plotly static charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

11.1 The view function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

ii

13.2 RunFrozenPython . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

14.2 OneDrive for Business . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

14.3 SharePoint (Online and On-Premises) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

14.4 Implementation Details & Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

15 故障排查 55

15.1 问题: 未找到 dll 文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

15.2 Issue: Files that are saved on OneDrive or SharePoint cause an error to pop up . . . . . . . . 55

16 转换器及选项 57

16.1 缺省转换器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

16.2 内置转换器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

16.3 自定义转换器 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

19.1 Quickstart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

19.2 Changing the Ribbon menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

19.3 Importing UDFs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

19.4 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

19.5 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

19.6 Renaming your add-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

19.7 Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

20 多线程和多进程 81

20.1 多线程 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

20.2 多进程 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

23.1 PRO Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

23.2 More Infos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

24.1 Quickstart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92