状态命令 （Team Foundation 版本控制）

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

Visual Studio 2019 |Visual Studio 2022

Team Foundation 版本控制（TFVC）status 命令或其别名 stat，显示有关一个或多个工作区中挂起文件和文件夹更改和挂起更改候选项的信息。 使用 /shelveset 选项时，该命令会显示有关搁置集中挂起的更改的信息。

注意

待定更改候选项是工作区的文件夹或子文件夹中的文件，该文件未添加到版本控制中。 若要查看 Visual Studio 中的所有待定更改候选项，请转到 团队资源管理器挂起的更改排除的更改，然后选择“检测到”。

先决条件

若要使用 status 命令，请具有源项的 读取 权限以及 签出 和 合并 权限，目标文件夹设置为 “允许”。 有关详细信息，请参阅 默认 TFVC 权限。

语法

tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]] 
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]

参数

参数

参数

说明

/collection: <TeamProjectCollectionUrl>

使用 /workspace 选项时，指定包含包含挂起更改的工作区的项目集合的 URL。 例如：http://myserver:8080/tfs/DefaultCollection。

如果未指定，则默认情况下，项目集合假定为包含映射当前目录的工作区的项目集合。

如果不使用 /workspace 选项，则忽略。

注意

有关此选项的限制，请参阅 备注。

/format

指定要显示每个挂起更改的详细信息：

• Brief（默认值）：显示一行关于每个挂起的更改，包括：文件名、更改、项是否锁定，如星号 *、本地路径和用户使用 /collection 和 /workspace 选项。 某些数据可能会被截断。
• Detailed：显示每个挂起更改的完整说明。 除了上述信息，此选项还显示更多数据，例如日期和时间。

<itemspec>

指定要等待更改数据的项。 有关语法，请参阅 使用 Team Foundation 版本控制命令。 可以指定多个 itemspec 参数。

/login

指定要用于运行命令的用户帐户。 请参阅 使用 Team Foundation 版本控制命令。

/recursive

以递归方式检索有关对指定目录和任何子目录中项的挂起更改的数据。

/shelveset:<shelvesetname>[;<shelvesetowner>]

指定包含要列出的更改的货架集。

此选项不能与 /workspace 选项结合使用。

/user

列出指定用户所做的所有挂起更改。 星号 * 包括有关所有用户更改的数据。 默认值为当前用户。

此选项的可接受值：

• <username>
• <useraccount>
• 星号 *

注意

有关此选项的限制，请参阅 备注。

/workspace:<workspacename>[;<workspaceowner>]

指定包含挂起更改的工作区的名称。 如果未指定，则工作区是映射当前目录的工作区。

可以指定 workspaceowner 来获取属于特定用户的工作区中挂起更改的数据。 如果未指定，则工作区假定为当前用户，或者如果指定，则为 /login:<username>。

此选项不能与 /shelveset 选项结合使用。

注意

有关此选项的限制，请参阅 备注。

言论

可以使用 status 命令查看当前工作区中的挂起更改，例如映射当前目录的工作区，无论它是本地工作区还是服务器工作区。 还可以使用此命令查看远程服务器工作区中挂起的更改，例如其他用户在另一个开发计算机上通过使用 /collection、/user和 /workspace 选项所做的更改。 但是，无法在远程本地工作区中查看挂起的更改。

有关详细信息，请参阅 决定使用本地工作区或服务器工作区。

例子

在以下示例中，假设 $/SiteApp/Main/ 映射到工作区中的 c：\code\SiteApp\Main\。

列出当前工作区中的所有更改

以下示例列出工作区中所有挂起的更改：

c:\code\SiteApp\Main\SolutionA\>tf stat

列出文件夹中的所有更改

以下示例列出对 SolutionA 文件夹中所有项的所有挂起更改：

c:\code\SiteApp\Main>tf stat SolutionA\*

列出文件夹及其子文件夹中的所有更改

以下示例列出了 SolutionA 文件夹中所有项的挂起更改，包括其子文件夹中的更改：

c:\code\SiteApp\Main>tf stat SolutionA\* /recursive

后续步骤

• 对版本控制下的文件所做的大多数更改都作为工作区中挂起的更改排队。 有关详细信息，请参阅 开发代码和管理挂起的更改，创建和使用工作区。

• 可以使用 Difference 命令 获取文件中有关编辑更改或更改内容的详细信息。

• 如果需要留出更改，并且可能还需要清理工作区以执行其他任务，请使用 Shelve 命令。 有关货架的详细信息，请参阅 暂停工作和管理货架。

• 准备好签入对服务器的更改时，请使用 签入命令。

• 有关如何使用 tf 实用工具的详细信息，请参阅 使用 Team Foundation 版本控制命令