Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

userpath

查看或更改默认用户工作文件夹

说明

示例

userpath 返回用户特定的文件夹(MATLAB® 在启动时将其添加到搜索路径中),指定为字符向量。

示例

userpath(newpath) 将搜索路径中的用户特定文件夹设置为 newpath。使用 userpath 指定的文件夹不仅立即而且在以后的会话中启动时都将显示在搜索路径中。MATLAB 将从搜索路径中删除之前由 userpath 指定的文件夹。

userpath('reset') 将搜索路径上的用户特定文件夹设置为您的平台的默认文件夹。默认的 userpath 文件夹因平台而异。

  • Windows® 平台 - %USERPROFILE%/Documents/MATLAB

  • Mac 平台 - $home/Documents/MATLAB

  • Linux® 平台 - $home/Documents/MATLAB(如果 $home/Documents 存在)。

MATLAB 会立即将该默认文件夹添加到搜索路径中,在以后的会话中启动时也会将该文件夹添加到搜索路径。在 Windows 和 Mac 平台上,如果默认文件夹不存在,将创建该文件夹。在 Linux 上,如果默认文件夹不存在,将不会创建该文件夹。

示例

userpath('clear') 会立即从搜索路径中删除用户特定文件夹,对于将来的 MATLAB 会话也是如此。

示例

全部折叠

此示例假定 userpath 文件夹设置为 Windows 平台上的默认值 Documents\MATLAB。启动 MATLAB 并显示当前文件夹:

pwd
H:\Documents\MATLAB

在此示例中,HDocuments 所在的驱动器。

确认当前文件夹为 userpath 文件夹。

userpath
H:\Documents\MATLAB

显示搜索路径。MATLAB 返回搜索路径,包括 userpath 指定的文件夹。

path
MATLABPATH

	H:\Documents\MATLAB
	C:\Program Files\MATLAB\R2009a\toolbox\matlab\general
	C:\Program Files\MATLAB\R2009a\toolbox\matlab\ops
...

假定 userpath 文件夹设置为 Windows 平台上的默认值,即 Documents\MATLAB

将值从默认值更改为 C:\Research_Project

newpath = 'C:\Research_Project';
userpath(newpath)

查看对搜索路径进行更改的影响。

path
MATLABPATH

	C:\Research_Project
	C:\Program Files\MATLAB\R2009a\toolbox\matlab\general
	C:\Program Files\MATLAB\R2009a\toolbox\matlab\ops
...

MATLAB 显示搜索路径,包括 userpath 指定的文件夹。当使用 userpath 分配新文件夹时,MATLAB 会自动从搜索路径中删除 userpath 文件夹的先前值 H:\Documents\MATLAB

假定 userpath 文件夹设置为默认值,但您不希望在启动时将其添加到搜索路径。

确认已设置默认值。

userpath
H:\Documents\MATLAB

验证它是否在搜索路径中。

path
MATLABPATH

H:\Documents\MATLAB
C:\Program Files\MATLAB\R2009a\toolbox\matlab\general
C:\Program Files\MATLAB\R2009a\toolbox\matlab\ops
...

清除该值。

userpath('clear')

确认结果。

userpath
ans =
     ''

确认以前的 userpath 文件夹已从搜索路径中删除。

path
MATLABPATH

C:\Program Files\MATLAB\R2009a\toolbox\matlab\general
C:\Program Files\MATLAB\R2009a\toolbox\matlab\ops
...

注意

如果使用 userpath('clear'),启动文件夹将不一定位于搜索路径中。如果从搜索路径中删除 userpath 文件夹并保存更改,也可能发生这种情况。

输入参数

全部折叠

userpath 文件夹的新值,指定为字符向量或字符串标量。newpath 必须为绝对路径。

示例: 'C:\myFolder'

数据类型: char | string

局限性

  • MATLAB Online™ 中,您只能查看 userpath 指定的文件夹。不支持更改文件夹。

提示

  • 要指定启动文件夹,请设置位于预设项窗口常规预设项页中的初始工作文件夹预设项。

  • MATLABPATH 环境变量可以包含要添加到搜索路径中的文件夹的列表。MATLAB 在启动时将 MATLABPATH 环境变量中指定的文件夹添加到搜索路径中 userpath 文件夹之下。

版本历史记录

在 R2008a 中推出