求助：在LibreOffice Calc中创建可接收任意单元格参数的简易Python自定义函数（UDF）

嗨！作为化学家，我完全懂你不想被复杂编程术语折磨的心情——就想要个能像Calc内置函数那样，随便选几个单元格就能计算的自定义Python函数对吧？我给你整理了两个超简单的方法，一步步来，保证你能搞定！

方法一：用APSO快速创建可直接调用的UDF（最推荐，步骤最少） #

APSO是LibreOffice的一个扩展，专门用来简化Python脚本的操作，先确保你装了它：

• 打开LibreOffice，点击「工具」→「扩展管理器」，搜索APSO安装，装完重启LibreOffice。

接下来一步步做：

1. 打开Calc表格，点击「工具」→「APSO」→「Script Organizer」（脚本管理器）
2. 在脚本管理器里，点击「新建」：
   • 保存位置选「我的宏」→「Python」
   • 给脚本文件起个名字，比如my_udfs.py，点击确定
3. 在弹出的编辑器里，复制粘贴下面的代码：

def MySum(a, b, c):
    # 自动识别传入的是单元格还是直接数值，提取数值
    def get_value(input_data):
        try:
            # 如果是单元格，获取它的数值
            return input_data.getValue()
        except AttributeError:
            # 如果是直接输入的数字，直接返回
            return input_data
    return get_value(a) + get_value(b) + get_value(c)

def VOL(a, b, c):
    def get_value(input_data):
        try:
            return input_data.getValue()
        except AttributeError:
            return input_data
    return get_value(a) * get_value(b) * get_value(c)

# 这行是关键！告诉LibreOffice这些函数是可以调用的UDF
g_exportedScripts = MySum, VOL

4. 保存脚本，关闭编辑器
5. 回到Calc单元格，直接输入=MySum(A1,B2,C3)或者=VOL(D4,E5,F6)，就能计算任意单元格的数值啦！

为啥你之前的代码报错？ #

你之前在APSO控制台写的是「宏」——就是需要手动点击运行的脚本，而不是可以直接在单元格调用的UDF。而且控制台里定义的函数不会被保存，必须写到脚本文件里，加上g_exportedScripts这行，LibreOffice才能识别它是可调用的函数哦。

方法二：手动创建带提示的Add-In（适合长期使用） #

如果想要你的函数像内置函数那样，输入时显示参数说明，就用这个方法，步骤稍多但更专业：

1. 打开系统自带的文本编辑器（比如Windows的记事本、Linux的gedit），复制粘贴下面的代码：

import unohelper
from com.sun.star.sheet import XAddIn

class MyCalcUDF(unohelper.Base, XAddIn):
    def __init__(self, ctx):
        self.ctx = ctx

    # 你的自定义函数逻辑
    def MySum(self, a, b, c):
        def get_val(x):
            try:
                return x.getValue()
            except:
                return x
        return get_val(a) + get_val(b) + get_val(c)
    
    def VOL(self, a, b, c):
        def get_val(x):
            try:
                return x.getValue()
            except:
                return x
        return get_val(a) * get_val(b) * get_val(c)

    # 下面的代码是让函数在Calc里显示提示，不用改太多
    def getProgrammaticName(self):
        return "MyCalcUDF"

    def getDisplayString(self, aProgrammaticName):
        return aProgrammaticName

    def getFunctionDescription(self, aProgrammaticName):
        if aProgrammaticName == "MySum":
            return "计算三个数的和，支持单元格或直接数值"
        elif aProgrammaticName == "VOL":
            return "计算三个数的乘积（体积），支持单元格或直接数值"
        return ""

    def getArgumentDescription(self, aProgrammaticName, nArgument):
        if aProgrammaticName == "MySum":
            if nArgument == 0:
                return "第一个数/单元格"
            elif nArgument == 1:
                return "第二个数/单元格"
            elif nArgument == 2:
                return "第三个数/单元格"
        elif aProgrammaticName == "VOL":
            if nArgument == 0:
                return "长度/单元格"
            elif nArgument == 1:
                return "宽度/单元格"
            elif nArgument == 2:
                return "高度/单元格"
        return ""

    def getFunctionCategory(self, aProgrammaticName):
        return 1  # 把函数归到数学函数分类，和内置SUM同组

# 注册这个Add-In，不用改
def createInstance(ctx):
    return MyCalcUDF(ctx)

g_ImplementationHelper = unohelper.ImplementationHelper()
g_ImplementationHelper.addImplementation(
    createInstance,
    "org.example.MyCalcUDF",
    ("com.sun.star.sheet.AddIn",),
)

2. 保存文件为MyCalcUDF.py，然后放到LibreOffice的Python脚本目录：
   • Windows：C:\Users\你的用户名\AppData\Roaming\LibreOffice\4\user\Scripts\python
   • Linux：~/.config/libreoffice/4/user/Scripts/python
   • Mac：~/Library/Application Support/LibreOffice/4/user/Scripts/python
3. 重启LibreOffice Calc，现在输入=MySum(的时候，就会弹出参数提示啦！

小提示 #

• 如果单元格是空的，函数会把它当成0计算；要是想处理空值，可以在get_value函数里加个判断，普通需求不用改也完全够用。
• 要是想加更多自定义函数，直接在脚本里按同样的格式写，然后加到g_exportedScripts里就行。

备注：内容来源于stack exchange，提问作者Alex Alex