如何在Matlab运行测试时使用自定义路径并限制工具箱代码访问

要确保测试仅能访问当前工具箱内的代码，核心思路是动态控制MATLAB的搜索路径——在测试执行前重置路径为仅包含当前工具箱和MATLAB核心运行所需的基础路径，测试结束后恢复原路径。以下是具体实现方法：

方法一：在测试类中通过Setup/Teardown管理路径 #

在测试类的TestMethodSetup方法中保存原始路径并重置隔离路径；在TestMethodTeardown方法中恢复原路径，确保每个测试用例都在独立环境中运行。

示例代码：

classdef MyToolboxTest < matlab.unittest.TestCase
    properties
        originalPath  % 保存MATLAB原始搜索路径
        toolboxRoot   % 当前工具箱的根目录路径
    end

    methods (TestMethodSetup)
        function setupIsolatedPath(testCase)
            % 保存原始路径
            testCase.originalPath = path;
            
            % 获取当前工具箱根目录（假设测试文件位于工具箱的tests子目录下）
            testCase.toolboxRoot = fileparts(fileparts(mfilename('fullpath')));
            
            % 重置路径：仅保留当前工具箱 + MATLAB核心必要路径
            path('');  % 清空现有路径
            addpath(genpath(testCase.toolboxRoot));  % 添加当前工具箱所有子目录（按需调整）
            
            % 添加MATLAB核心运行和测试框架所需路径
            corePaths = [
                fullfile(matlabroot, 'toolbox', 'matlab');
                fullfile(matlabroot, 'toolbox', 'local');
                fullfile(matlabroot, 'toolbox', 'matlab', 'unittest')
            ];
            addpath(corePaths);
        end
    end

    methods (TestMethodTeardown)
        function restoreOriginalPath(testCase)
            % 测试结束后恢复原始路径
            path(testCase.originalPath);
        end
    end

    methods (Test)
        function testSampleFunction(testCase)
            % 测试代码仅能访问当前工具箱和MATLAB核心函数
            output = sampleFunction(123);
            testCase.verifyEqual(output, 456);
        end
    end
end

方法二：封装为Test Fixture复用逻辑 #

如果多个测试类都需要路径隔离，可以将路径控制逻辑封装为Test Fixture，避免重复代码：

classdef IsolatedToolboxFixture < matlab.unittest.fixtures.Fixture
    properties
        originalPath
        toolboxRoot
    end

    methods
        function fixture = IsolatedToolboxFixture(toolboxRoot)
            fixture.toolboxRoot = toolboxRoot;
        end
    end

    methods (Access = protected)
        function setup(fixture)
            fixture.originalPath = path;
            path('');
            addpath(genpath(fixture.toolboxRoot));
            % 添加核心路径（同方法一）
            corePaths = [
                fullfile(matlabroot, 'toolbox', 'matlab');
                fullfile(matlabroot, 'toolbox', 'local');
                fullfile(matlabroot, 'toolbox', 'matlab', 'unittest')
            ];
            addpath(corePaths);
        end

        function teardown(fixture)
            path(fixture.originalPath);
        end
    end
end

在测试类中使用该Fixture：

classdef AnotherToolboxTest < matlab.unittest.TestCase
    methods (Test)
        function testAnotherFunction(testCase)
            % 指定当前工具箱根目录
            fixture = IsolatedToolboxFixture(fileparts(fileparts(mfilename('fullpath'))));
            testCase.applyFixture(fixture);
            
            % 执行测试
            result = anotherFunction('input');
            testCase.verifyTrue(result);
        end
    end
end

关键注意事项 #

• 按需调整addpath的目录：如果工具箱内有不需要测试的子目录，不要使用genpath，而是手动添加需要的目录，避免引入无关代码。
• 确保核心路径完整：如果测试中用到MATLAB其他核心工具（比如数值计算、字符串处理），需要对应添加matlabroot/toolbox/matlab下的子目录（如mathworks、strfun等）。
• 避免全局路径污染：测试结束后必须恢复原始路径，防止影响后续的MATLAB操作或其他测试。

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