如何在Python中解包C# DLL返回的ValueTuple？

问题原因 #

C#的ValueTuple<Int32, String>是.NET专属的值类型，Python无法直接将其识别为可迭代对象，因此常规的元组解包语法会抛出TypeError。

解决方案 #

方案1：直接访问ValueTuple的属性 #

C# ValueTuple会默认生成Item1、Item2等属性对应元组的各个元素，直接读取这些属性即可：

result = MyObj.myFunc()
err = result.Item1
errstring = result.Item2

如果想一行完成解包，建议先缓存结果再操作：

result = MyObj.myFunc()
err, errstring = result.Item1, result.Item2

方案2：转换为Python原生元组 #

把C# ValueTuple的元素提取出来，组装成Python原生元组后再解包：

def to_python_tuple(vt):
    return (vt.Item1, vt.Item2)

err, errstring = to_python_tuple(MyObj.myFunc())

如果仅单次使用，也可以直接写：

err, errstring = (MyObj.myFunc().Item1, MyObj.myFunc().Item2)

注意：这种写法会调用两次myFunc方法，如果方法有副作用（比如修改状态、耗时操作），务必先把结果存入变量再处理。

方案3：修改C# DLL（可选） #

如果有权限修改C#代码，可以调整返回类型或参数形式：

// 改用引用类型Tuple
public Tuple<int, string> myFunc()
{
    return Tuple.Create(0, "hello");
}

// 或者使用out参数
public void myFunc(out int err, out string errstring)
{
    err = 0;
    errstring = "hello";
}

对应的Python调用方式：

• 对于Tuple<int, string>：同样通过Item1、Item2访问，部分互操作库可能会自动识别为可迭代对象（视库版本而定）。
• 对于out参数（以pythonnet为例）：

err = 0
errstring = ""
MyObj.myFunc(out err, out errstring)

内容的提问来源于stack exchange，提问作者Rayon Magique