> For the complete documentation index, see [llms.txt](https://man.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://man.bsdcn.org/man1/mv.1.md).

# mv(1)

`mv` — 移动文件

## 名称

`mv`

## 概要

`mv [-f | -i | -n] [-hv] source target`

`mv [-f | -i | -n] [-v] source ... directory`

## 描述

在第一种形式中，`mv` 实用程序将 `source` 操作数命名的文件重命名为 `target` 操作数命名的目标路径。当最后一个操作数命名的不是已存在的目录时，假定使用此形式。

在第二种形式中，`mv` 将每个 `source` 操作数命名的文件移动到 `directory` 操作数命名的现有目录中的目标文件。每个操作数的目标路径是由最后一个操作数、斜杠和命名文件的最后路径分量连接而成的路径名。

以下选项可用：

**`-f`** 在覆盖目标路径之前不提示确认。（`-f` 选项覆盖任何先前指定的 `-i` 或 `-n` 选项。）

**`-h`** 如果 `target` 操作数是指向目录的符号链接，则不跟随它。这使 `mv` 实用程序将文件 `source` 重命名为目标路径 `target`，而非将 `source` 移动到 `target` 引用的目录中。

**`-i`** 使 `mv` 在移动会覆盖现有文件之前向标准错误输出写入提示。如果来自标准输入的响应以字符 ‘`y`’ 或 ‘`Y`’ 开头，则尝试移动。（`-i` 选项覆盖任何先前指定的 `-f` 或 `-n` 选项。）

**`-n`** 不覆盖现有文件。（`-n` 选项覆盖任何先前指定的 `-f` 或 `-i` 选项。）

**`-v`** 使 `mv` 详细输出，在文件移动后显示它们。

如果 `source` 操作数指定的是目录，而目标存在且不是目录，则是错误的。

如果目标路径的权限不允许写入，`mv` 按 `-i` 选项的规定提示用户确认。

由于 [rename(2)](/sys/rename.2.md) 调用不能跨文件系统工作，`mv` 使用 [cp(1)](/man1/cp.1.md) 和 [rm(1)](/man1/rm.1.md) 来完成移动。其效果等价于：

```sh
rm -f destination_path && \
cp -pRP source_file destination && \
rm -rf source_file
```

## 退出状态

`mv` 实用程序成功时退出值为 0，发生错误时大于 0。

## 实例

将文件 `foo` 重命名为 `bar`，如果 `bar` 已存在则覆盖它：

```sh
$ mv -f foo bar
```

## 兼容性

`-h`、`-n` 和 `-v` 选项是非标准的，不建议在脚本中使用。

## 参见

[cp(1)](/man1/cp.1.md), [rm(1)](/man1/rm.1.md), [symlink(7)](/man7/symlink.7.md)

## 标准

`mv` 实用程序预期与 IEEE Std 1003.2 ("POSIX.2") 兼容。

## 历史

`mv` 命令首次出现于 Version 1 AT\&T UNIX。