环境准备与基础配置

要在LibreOffice Calc中使用Python脚本，首先需要确保系统已安装必要的组件。对于Ubuntu 18.04用户，可以通过以下命令安装Python支持包：

sudo apt-get install libreoffice-script-provider-python python3-uno

安装完成后，重启LibreOffice使配置生效。可以通过以下方法验证Python宏是否可用：

工具 → 宏 → 组织宏 → Python

创建第一个Python宏

下面我们实现一个简单的示例，计算(A1+A2)^4并将结果写入A3单元格：

def compute_power():
    # 获取当前活动文档
    doc = XSCRIPTCONTEXT.getDocument()
    # 获取第一个工作表
    sheet = doc.Sheets.getByIndex(0)
    
    # 获取A1和A2单元格的值
    a1 = sheet.getCellRangeByName("A1").getValue()
    a2 = sheet.getCellRangeByName("A2").getValue()
    
    # 计算结果
    result = (a1 + a2) ** 4
    
    # 将结果写入A3单元格
    sheet.getCellRangeByName("A3").setValue(result)

# 必须定义这个变量，LibreOffice才能识别为宏
g_exportedScripts = (compute_power,)

宏的调用与调试

创建宏后，可以通过以下方式调用：

1. 将代码保存到~/.config/libreoffice/4/user/Scripts/python/目录下，文件扩展名为.py
2. 在Calc中按Alt+F11打开宏管理器
3. 选择Python宏并执行

调试技巧：可以在代码中添加print语句，输出会显示在LibreOffice的Python控制台中（通过工具 → Python控制台打开）。

进阶应用示例

下面是一个更实用的例子，批量处理单元格数据：

def batch_process():
    doc = XSCRIPTCONTEXT.getDocument()
    sheet = doc.Sheets.getByIndex(0)
    
    # 获取A列数据范围
    range = sheet.getCellRangeByName("A1:A10")
    data = range.getDataArray()
    
    # 处理数据
    results = []
    for row in data:
        value = row[0] if row else 0
        results.append([value * 2])  # 示例：每个值乘以2
    
    # 写入B列
    sheet.getCellRangeByName("B1:B10").setDataArray(results)

g_exportedScripts = (batch_process,)

常见问题解决

问题1：宏不显示
检查文件是否保存在正确的目录，文件名是否以.py结尾，以及是否定义了g_exportedScripts变量。

问题2：权限错误
确保Python脚本有可执行权限，可以使用chmod +x script.py命令。

问题3：API调用失败
LibreOffice的Python API文档可以在https://api.libreoffice.org/查阅，遇到问题时建议先查阅官方文档。