Main Content

addpath

向搜索路径中添加文件夹

说明

示例

addpath(folderName1,...,folderNameN) 将指定的文件夹添加到当前 MATLAB® 会话的搜索路径的顶层。

如果输入是由路径分隔符分隔的多个文件夹组成的集合,则会添加每个指定的文件夹。

示例

addpath(folderName1,...,folderNameN,position) 将指定的文件夹添加到 position 指定的搜索路径的最前面或最后面。

示例

addpath(___,'-frozen') 还会为所添加的文件夹禁用文件夹更改检测。为文件夹禁用文件夹更改检测后,MATLAB 将不会检测从 MATLAB 以外的地方对文件夹所做的更改。

请将此语法与上述语法中的任何参数结合使用。可以按任一顺序指定 '-frozen'position

示例

此外,oldpath = addpath(___) 返回在添加指定文件夹之前的路径。

示例

全部折叠

创建一个文件夹,将其添加到您的搜索路径的最前面,然后保存搜索路径以用于将来的 MATLAB® 会话。

mkdir('matlab/myfiles')   
addpath('matlab/myfiles')  
savepath matlab/myfiles/pathdef.m

创建 matlab/myfiles 文件夹并将其添加到搜索路径的最底端。

mkdir('matlab/myfiles')
addpath('matlab/myfiles','-end')

matlab/myfiles 及其子文件夹添加到搜索路径。

创建文件夹 matlab/myfiles 并在 addpath 内调用 genpath,以将 matlab/myfiles 的所有子文件夹添加到搜索路径中。

mkdir('matlab/myfiles')
addpath(genpath('matlab/myfiles'))

创建文件夹 matlab/myfiles。然后,将其添加到搜索路径的最前面,禁用文件夹更改通知,并返回添加文件夹之前的搜索路径。

mkdir('matlab/myfiles')
oldpath = addpath('matlab/myfiles','-frozen');

MATLAB® Online™ 不支持禁用文件夹更改通知。

输入参数

全部折叠

要添加到搜索路径中的文件夹名称,指定为一个或多个字符向量或字符串标量。对每个文件夹使用完整的路径名。使用 genpathaddpath 添加 folderName 的所有子文件夹。

示例: 'c:\matlab\work'

示例: '/home/user/matlab'

示例: '/home/user/matlab','/home/user/matlab/test'

MATLAB 会先将所有包含 '.'、'..' 和符号链接的路径名称解析为其目标位置,然后再将其添加到路径。这样可以确保 MATLAB 路径中的每个条目代表一个唯一的文件夹位置。例如,如果您指定 c:\matlab\..\work,MATLAB 会将文件夹 c:\work 添加到路径中。

数据类型: char | string

搜索路径中的位置,指定为以下值之一:

position 的值

描述

'-begin'

将指定文件夹添加到搜索路径的顶层。

'-end'

将指定文件夹添加到搜索路径的底层。

输出参数

全部折叠

添加文件夹之前的路径,以字符向量形式返回。

提示

  • 要保存新修改的搜索路径以用于将来的 MATLAB 会话,请使用 savepath 函数。

  • 要在启动时以编程方式修改搜索路径,请在 startup.m 文件中使用 addpath 语句。有关详细信息,请参阅在启动时将文件夹添加到 MATLAB 搜索路径

算法

如果您在局部函数内使用 addpath,则从该函数返回程序控制后会保留路径更改。即路径更改的范围是全局的。

版本历史记录

在 R2006a 之前推出