重命名命令 （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将文件或文件夹移动到新位置。
注意
在签入之前，此命令的结果不会反映在服务器中。 有关详细信息，请参阅 开发代码和管理挂起的更改。
先决条件
若要使用
语法
tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem
参数
参数
参数
说明
<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。 - 通过提供路径不同于
olditemnewitem（例如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