Rename 命令（Team Foundation 版本控制）
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Team Foundation 版本控制 (TFVC) rename 命令可更改文件或文件夹的名称或路径。 可以使用 rename 命令或别名 move 或 ren 将文件或文件夹移动到新位置。
注意
在执行签入之前，此命令的结果不会反映在服务器中。 有关详细信息，请参阅开发代码和管理挂起的更改。
先决条件
若要使用 rename 命令，必须将“签出”权限设置为“允许”。 有关详细信息，请参阅默认 TFVC 权限。
语法
tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem
参数
参数
Argument
说明
<olditem>
要重命名的文件或文件夹的原始名称和路径。 可以指定本地工作区路径（例如 C:\myfiles\314.cs）或 TFVC 服务器路径（例如 $/myfiles/314.cs）。
<newitem>
文件或文件夹的新名称。 可用于指定其他本地或 TFVC 服务器路径位置。
<username>
为 /login 选项提供值。 可以将用户名值指定为 DOMAIN\username 或 username。
选项
选项
说明
/lock
包含此选项以阻止其他用户签入或签出指定项。 如果未指定此选项，则不会更改该项的现有锁定状态。 有关详细信息，请参阅了解锁定类型。
锁定选项：
None：未应用锁定。Checkin：其他用户可以签出指定项，但在你通过执行签入来释放锁定之前，他们无法签入对锁定文件的修订。 如果任何其他用户已经锁定了任何指定项，锁定操作将失败。Checkout：在你通过执行签入来释放锁定之前，此选项会阻止其他用户签入或签出任何指定项。 如果任何其他用户已经锁定了任何指定项，锁定操作将失败。
/login
指定用户名和密码，以便使用 Azure DevOps 对用户进行身份验证。
注解
可以使用 tf 命令行实用工具的 rename 命令在工作区中移动或重命名受版本控制的项。 使用 rename 命令通过指定通配符来移动多个文件。 只能从命令行重命名多个受版本控制的文件或文件夹。
使用 rename 命令执行以下操作：
- 将
olditem重命名为newitem，例如tf rename 314.cs 315.cs。 - 通过提供路径不同于
olditem的newitem（例如tf rename 314.cs ..\newdir\314.cs），将olditem移动到 TFVC 服务器中的新位置。
如果提供的 newitem 指定了不存在的文件夹，则 rename 命令会创建目标文件夹。 如果 newitem 是文件夹，则 olditem 将成为 newitem 的子项。
在以下情况下，无法重命名项：
- 在将项签入同一工作区之前，已将其删除。
- 新名称已存在于 TFVC 服务器中并且不是文件夹。
- 你已添加、分支或重命名了项的挂起的签入。
- 项已映射到工作区，但在本地磁盘上不可用。
- 项已掩蔽。
可以重命名已添加另一个同名文件以待签入的项，但无法重命名已分支但尚未签入的项。 重命名包含挂起的编辑的文件时，编辑将被保留。
如果不首先更改映射，则无法重命名显式映射的项。 例如，如果存在 $/ProjectX/MyApp 到 c:\MyApp 的工作文件夹映射，则无法重命名 MyApp。 可以重命名 MyApp 下的项，但无法重命名 MyApp 本身。
有关如何使用 tf 命令行实用工具的详细信息，请参阅使用 Team Foundation 版本控制命令。
示例
以下示例将 314.cs 的名称更改为 1254.cs。
c:\projects>tf rename 314.cs 1254.cs
以下示例将 314.cs 重命名为 1254.cs 并将其移至 newdir 文件夹。
c:\projects>tf rename 314.cs ..\newdir\1254.cs
以下示例将 Form1.vb 的名称更改为 MainPage.vb 并对其应用锁定。
c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin