在 Azure DevOps 中重命名项目

  • 项目

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

在 Azure DevOps 中重命名项目会更新版本控制路径、工作项、查询和其他项目项目中的项目名称。 可以多次重命名单个项目，并使用旧名称。 重命名后，可能需要团队成员执行某些操作。

警告

GitHub Copilot：重命名项目后，如果用户计数小于 1,000，则 Azure DevOps 通过电子邮件通知所有项目成员。 对于超过 1,000 个用户的项目，只有 Project Collection 管理员istrators 收到这些通知。

工作负荷标识联合：重命名项目将中断 Azure 资源管理器 服务连接中的工作负荷标识联合主体。

先决条件

  • 必须是 Project 管理员istrators 组的成员，或者将项目级重命名团队项目权限设置为“允许”。 有关详细信息，请参阅更改项目级权限。
  • 必须是 Project 管理员istrators 组的成员，或者将项目级重命名团队项目权限设置为“允许”。 有关详细信息，请参阅更改项目级权限。

重命名项目

  1. 登录到组织（https://dev.azure.com/{Your_Organization}），然后打开要重命名的项目。

  2. 选择“项目设置概述”>，然后输入新名称，然后选择“保存”。

    Screenshot showing new name entry and highlighted save button.

  3. 若要确认重命名，请输入新的项目名称，检查“我了解重命名此项目的后果”旁边的框，然后选择“保存”。

    Screenshot showing new name confirmation screen with save button.

重命名的结果

重命名操作后会出现以下结果。

  • Azure DevOps 重命名项目。

  • 如果成员少于 1,000 个，则所有项目成员都会收到名称更改的电子邮件通知。

  • 该 URL 将继续适用于新团队名称和旧团队名称。 此功能旨在避免中断链接。

  • 如果 URL 中的项目是组织中的有效项目，我们将显示提供的工作项 ID。 以下示例显示了名为“Example1”和“Example2”的项目的组织。

    https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/ - 显示工作项 40 https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/ - 显示工作项 40 https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/ - 显示 404 错误

  • 工作项 ID 在组织中是唯一的，因此链接不会过期。

  • 可以再次使用旧项目名称。

使用重命名项目所需的用户操作

团队中的每个用户必须 重启其客户端 ，并根据他们使用的功能执行以下一些操作：

重启客户端

打开的客户端在内存中保留所有项目名称的缓存，但在重命名项目后，此缓存不会自动清除。 若要清除缓存，请重启客户端，以便填充新项目名称。 如果未重启客户端，则使用缓存项目名称的操作将失败，但 找不到 项目异常。

对于以下客户端，请在每个客户端中保存工作，然后重启：

更新 Git 远程

如果项目使用 Git，则必须更新重命名项目中每个存储库的远程引用。 这些更新是必需的，因为远程存储库 URL 包含项目和存储库名称。 Git 使用远程引用在本地存储库和存储在服务器上的远程版本之间提取和推送更改。 团队的每个成员都必须更新其本地 Git 存储库，才能继续从其开发计算机进行连接。

有关详细信息，请参阅 更新开发计算机上的 Git 远程服务器。

更新 TFVC 服务器工作区

如果项目对服务器工作区使用 TFVC，则必须使用新项目名称更新这些工作区。 对于 Visual Studio 客户端，请执行获取或检查，然后更正工作区映射以使用新项目名称。

Screenshot of source control explorer, showing get latest version selection.

有关详细信息，请参阅 Rename 命令（TFVC）。

更新 TFVC 本地工作区

如果团队将 TFVC 用于 本地工作区，则需要使用新项目名称更新这些工作区。 对于 Visual Studio，请执行 get 或 检查，并更正工作区映射以使用新项目名称。

建议尽可能将客户端更新到最新更新或发布。 对于所有其他受支持的 Visual Studio 版本，必须创建映射到新项目名称的新本地工作区。

本地工作区在本地进行管理，而不是在服务器上进行管理。 未更新重命名逻辑的旧客户端无法将本地工作区更新为新的项目名称。

常见问题 (FAQ)

问：由于现有工作区，为何尝试重复使用项目名称失败？

答：如果仍有用于寻址的项目映射，则不能重复使用项目名称。 此函数有助于避免将工作区映射到两个项目的不明确情况。 请联系具有这些映射的用户，并删除这些映射或 将其更新 为使用新名称。

如果包含工作区的用户的计算机不再可用，则可以通过从 Visual Studio 的开发人员命令提示符运行以下命令来删除工作区： tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]

问：重命名项目如何影响我的浏览器导航体验？

答：重命名项目后，打开项目的任何浏览器都可能会遇到一些错误。 这些错误是由于浏览器保留的缓存，其中包括旧的项目名称。 刷新以使这些错误消失，因为缓存使用新项目名称重新填充。

问：项目中的其他项目是否重命名？

答：是的，共享同名的所有项目都会随项目一起重命名。 唯一的例外是默认团队和存储库。 这些项目的重命名是尽最大努力执行的。 例如，如果项目 Foo 已重命名为 Bar，则如果项目中已存在名为 Bar 的团队，则不会重命名默认团队 Foo。

问：为什么在重命名后无法打开保存到磁盘的查询？

答：如果使用 Visual Studio 2010 并且查询保存到磁盘，则重命名项目后无法打开它们。 可以使用 Visual Studio 2012 或更高版本打开它们。