userpath

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

全页折叠

语法

userpath
userpath(newpath)
userpath("reset")
userpath("clear")

说明

userpath 返回用户特定的文件夹（MATLAB® 在启动时将其添加到搜索路径中）。该函数以字符向量形式返回该文件夹。有关搜索路径的详细信息，请参阅什么是 MATLAB 搜索路径？

有关配置 MATLAB 启动选项的详细信息，请参阅在 MATLAB 启动文件中指定启动选项。

示例

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

示例

userpath("reset") 将搜索路径上的用户特定文件夹设置为您的平台的默认文件夹。默认 userpath 文件夹取决于您的平台：

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

  • Mac 平台 - $home/Documents/MATLAB

  • Linux® 平台 - $HOME/Documents/MATLAB（如果 $HOME/Documents 存在）。如果 $HOME/Documents 不存在，函数会返回 [] 且未设置有效路径。

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

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

示例

示例

全部折叠

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

pwd
H:\Documents\MATLAB

在此示例中，H 是 Documents 所在的驱动器。

确认当前文件夹为 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"

局限性

  • 在 MATLAB Online™ 中，您只能查看 userpath 文件夹。不支持更改文件夹。

提示

  • 要指定启动文件夹，请设置位于“设置”窗口的常规设置页中的初始工作文件夹设置。有关使用 userpath 作为初始工作文件夹的详细信息，请参阅使用 userpath 作为初始工作文件夹。

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

版本历史记录

在 R2008a 中推出

另请参阅

函数

工具

主题