状态命令 (Team Foundation 版本控制)
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018
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]
参数
参数
Argument
说明
/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 命令。 有关搁置集的详细信息，请参阅 暂停工作和管理搁置集。
准备好签入服务器的更改后，请使用 Checkin 命令。
有关如何使用
tf实用工具的详细信息，请参阅 使用 Team Foundation 版本控制命令