Matlab inputParser误捕获首字符相同的非预期输入问题求助

问题背景 #

有一个测试函数，功能是返回输入值的平方，同时支持可选的offset偏移量参数：

function out=test_parser(a,varargin)
    % parse inputs
    parser=inputParser;
    parser.KeepUnmatched=true;
    addRequired(parser,'a',@isnumeric);
    addParameter(parser,'offset',0);
    parse(parser,a,varargin{:});
    offset=parser.Results.offset;
    out=a^2+offset;
end

正常调用结果 #

>> test_parser(2)
4
>> test_parser(2,'offset',1)
5

异常现象 #

当传入首字符与offset相同的其他名称-值对（比如'off'）时，尽管设置了parser.KeepUnmatched=true，该参数却被当作offset处理，返回结果5，而非预期的4。这影响了跨函数调用时的参数处理逻辑。

问题原因 #

这不是MATLAB的bug，而是对inputParser匹配规则的理解误区：

• MATLAB的inputParser默认开启部分匹配（Partial Matching），只要传入的参数名前缀与已定义的参数名前缀完全一致，就会被识别为对应参数，无需完整输入参数名。
• KeepUnmatched=true的作用是忽略完全不匹配的参数，而部分匹配的参数会优先被匹配到已定义的参数上，不会被归为未匹配项。

解决方案 #

如果需要严格匹配完整参数名，禁用部分匹配功能，只需在创建inputParser后添加一行设置：

parser.PartialMatching = false;

修改后的完整函数：

function out=test_parser(a,varargin)
    % parse inputs
    parser=inputParser;
    parser.KeepUnmatched=true;
    parser.PartialMatching = false; % 禁用部分匹配
    addRequired(parser,'a',@isnumeric);
    addParameter(parser,'offset',0);
    parse(parser,a,varargin{:});
    offset=parser.Results.offset;
    out=a^2+offset;
end

此时调用test_parser(2,'off',1)，'off'会被当作未匹配参数忽略，offset保持默认值0，返回结果为4，符合预期。

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