MATLAB含符号变量矩阵导入Python遇KeyError问题求解

我之前也碰到过一模一样的坑，MATLAB的符号变量存储结构和普通数值矩阵完全不一样，这就是你触发KeyError的核心原因——scipy.io.loadmat没法直接识别mat文件里的MATLAB符号对象，自然找不到名为f的顶层键。下面给你两种实用的解决办法：

方法一：在MATLAB端转成字符数组保存 #

把符号矩阵转换成字符形式再保存，Python读取后就能用sympy解析回符号表达式，步骤很简单：

修改后的MATLAB代码： #

syms x
f = [x^2 x^3 x^4];
f_str = char(f); % 将符号矩阵转为字符数组
save('sym.mat','f_str')

对应的Python读取代码： #

import scipy.io as sio
from sympy import sympify

# 读取mat文件
matrix = sio.loadmat('sym.mat')
# 把MATLAB的二维字符数组转成普通字符串
f_str = ''.join(matrix['f_str'].flatten().astype(str))
# 分割每个表达式并转为sympy符号对象
sym_f = [sympify(expr) for expr in f_str.split()]

print(sym_f) # 输出结果: [x**2, x**3, x**4]

方法二：用HDF5格式保存并通过h5py读取 #

MATLAB的-v7.3参数会将文件保存为HDF5格式，这种格式可以用h5py直接访问内部的符号变量结构，适合需要保留MATLAB符号对象原始信息的场景：

修改后的MATLAB代码： #

syms x
f = [x^2 x^3 x^4];
save('sym.mat','f','-v7.3') % 保存为HDF5格式的mat文件

对应的Python读取代码： #

import h5py
from sympy import sympify

with h5py.File('sym.mat', 'r') as mat_file:
    # 可以先查看文件内的所有结构，方便定位符号内容位置
    print(list(mat_file.keys()))
    # 提取符号矩阵的字符内容
    sym_raw = mat_file['f/char'][()].astype(str)
    # 拼接成完整的表达式字符串并分割
    expr_str = ''.join(sym_raw.flatten())
    sym_f = [sympify(expr) for expr in expr_str.split()]

print(sym_f) # 输出结果: [x**2, x**3, x**4]

问题根源解释 #

MATLAB的符号变量是sym类的实例，保存到mat文件时会以带有元数据的复杂结构体形式存储，而scipy.io.loadmat主要是为普通数值数组设计的，不会自动解析这种特殊对象的顶层键，所以你直接用matrix['f']会找不到对应的键。通过转字符或HDF5读取的方式，我们绕过了scipy对符号对象的支持不足，直接获取到符号表达式的文本内容，再用sympy转换成Python能识别的符号对象。

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