Checkout 和 Edit 命令
使本地文件可写，并更改其挂起的更改状态以在工作区中进行“编辑”。 Edit 是 Checkout 命令的别名。 有关更多信息，请参见挂起的更改。
提示
在执行签入操作之前，对已签出项所做的任何编辑不会反映在 Team Foundation 版本控制 服务器中。 有关更多信息，请参见 签入挂起的更改。
所需权限
若要使用 checkout 命令，必须将**“签出”权限设置为“允许”，并且您必须是工作区所有者或者必须将全局“管理工作区”权限设置为“允许”。 此外，如果所使用的 /lock 选项中包含一个非 none 值，则必须将“锁定”权限设置为“允许”**。 有关更多信息，请参见 Team Foundation Server 权限。
tf checkout [/lock:(none|checkin|checkout)] [/recursive]
[/type:encoding] itemspec [/login:username,[password]]
参数
参数 |
说明 |
|---|---|
encoding |
提供 /type 选项的值。 可选的值包括：作为当前 Windows 编码（美国系统上为 Windows-1252）别名的 Text、Unicode（基于 BOM 或字节顺序标记）、Binary 以及 Windows 操作系统支持的所有其他文件编码。 也可以使用 Auto，它可以为您检测类型。 有关更多信息，请参见 管理文件类型。 |
itemspec |
指定要签出的一个或多个文件。 您可以在此处使用通配符。 |
username |
向 /login 选项提供值。 可以按域\用户名或用户名的格式指定用户名值。 |
选项 |
说明 |
|---|---|
/type |
手动重写 Team Foundation 将其与指定文件关联的文件编码。 |
/recursive |
签出当前目录及其所有子文件夹中与项规范 匹配的所有文件。 |
/lock |
防止其他用户签入或签出指定文件。 有关更多信息，请参见 了解锁定类型。 锁定选项：
|
/login |
指定用于在 Visual Studio Team Foundation Server 中验证用户身份的用户名和密码。 |
备注
checkout 命令的默认行为由是否启用**“签出时获取项的最新版本”**设置来确定。 有关如何查看或更改此设置的更多信息，请参见启用 Team Foundation 版本控制以便在签出时获取最新文件。
如果已启用**“签出时获取项的最新版本”**，则 checkout 命令的行为与 Visual SourceSafe 中的签出行为类似。 如果工作区中不存在项的最新版本，则 Team Foundation 会从 Team Foundation Server 获取最新版本，并将其复制到工作区。 如果工作区中存在同一项的早期版本，则将使用最新版本覆盖它。
如果禁用**“签出时获取项的最新版本”**，则 Team Foundation 在签出操作过程中不会获取最新的 Team Foundation 版本控制服务器版本， 而是使当前工作区版本可写。 有关更多信息，请参见 获取团队项目的源代码。
可以使用 tf edit 作为 checkout 的别名。
默认情况下，多个用户可以同时签出同一个受版本控制的项。 当您使用 tf 签出一个在其他工作区中具有挂起更改的项时，有关其他这些挂起更改性质的信息将输出到命令行上。 在大多数协作开发环境中，您不大可能在您的工作区中执行与其他工作区中的挂起更改存在潜在合并冲突的更改，反之亦然。 Team Foundation 允许您自动解决所发生的大部分冲突。 对于无法自动解决的冲突，可以使用 Resolve 命令来安全地决定要保留哪一种更改，即您的更改或其他用户所做的更改。 如果您担心另一个用户可能会在其工作区进行一些与您的挂起更改冲突的更改，可以使用 Status 命令来监视其他工作区中是否有新应用的更改。 或者，可以使用 Lock 命令，以防止其他用户在您签入您自己的更改并取消更改的锁定之前签出或签入。 最佳做法是谨慎使用 lock 命令并通知团队成员为什么您要这样做以及您打算何时移除锁定。
有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。
示例
下面的示例使 314.cs 在磁盘上可写，并将其添加到该工作区的挂起更改列表中。
c:\pi> tf checkout 314.cs
下面的示例签出 314.cs 和 271.cs。
c:\pi>tf checkout 314.cs 271.cs
下面的示例签出 page.xsl，并将 Team Foundation 文件类型的编码属性更改为文本。 Text 是当前 Windows 编码（如 Windows-1252）的别名。
c:\pi>tf checkout /type:text page.xsl