zh-cn/setup/develop/repo.html - platform/docs/source.android.com - Git at Google

 <html devsite><head>
     <title>Repo 命令参考资料</title>
     <meta name="project_path" value="/_project.yaml"/>
     <meta name="book_path" value="/_book.yaml"/>
   </head>
   <body>
   <!--
       Copyright 2017 The Android Open Source Project

       Licensed under the Apache License, Version 2.0 (the "License");
       you may not use this file except in compliance with the License.
       You may obtain a copy of the License at

           http://www.apache.org/licenses/LICENSE-2.0

       Unless required by applicable law or agreed to in writing, software
       distributed under the License is distributed on an "AS IS" BASIS,
       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
       See the License for the specific language governing permissions and
       limitations under the License.
   -->

 <p>使用 Repo 需遵循的格式如下：</p>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo <var>command options</var>
 </pre>
 <p>可选元素显示在方括号 [ ] 中。例如，许多命令会用到项目列表 (project-list) 参数。<var></var>项目列表可以是一个名称列表，也可以是一个本地源代码目录的路径列表：<var></var></p>
 <pre class="devsite-click-to-copy">
 <code class="devsite-terminal">repo sync [<var>project0 project1 ... projectn</var>]</code>
 <code class="devsite-terminal">repo sync [<var>/path/to/project0 ... /path/to/projectn</var>]</code>
 </pre>

 <h2 id="help">help</h2>
 <p>安装 Repo 后，您可以通过运行以下命令找到最新文档（开头是包含所有命令的摘要）：</p>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo help
 </pre>
 <p>您可以通过在 Repo 树中运行以下命令来获取有关某个命令的信息：</p>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo help <var>command</var>
 </pre>

 <p>例如，以下命令会生成 Repo <code>init</code> 参数的说明和选项列表，该参数会在当前目录中初始化 Repo（要了解详情，请参阅 <a href="#init">init</a>）。</p>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo help init
 </pre>

 <h2 id="init">init</h2>
 <pre class="devsite-terminal devsite-click-to-copy">repo init -u <var>url</var> [<var>options</var>]
 </pre>
 <p>在当前目录中安装 Repo。这会创建一个 <code>.repo/</code> 目录，其中包含用于 Repo 源代码和标准 Android 清单文件的 Git 代码库。该 <code>.repo/</code> 目录中还包含 <code>manifest.xml</code>，这是一个指向 <code>.repo/manifests/</code> 目录中所选清单的符号链接。有关更新清单的说明，请参阅 <a href="https://gerrit.googlesource.com/git-repo/+/master/docs/manifest-format.md" class="external">manifest-format.md</a>。</p>
 <p>选项：</p>
 <ul>
 <li>
 <p><code>-u</code>：指定要从中检索清单代码库的网址。您可以在 <code>https://android.googlesource.com/platform/manifest</code> 中找到通用清单</p>
 </li>
 <li>
 <p><code>-m</code>：选择代码库中的一个清单文件。如果未选择任何清单名称，则会默认选择 default.xml。</p>
 </li>
 <li>
 <p><code>-b</code>：指定修订版本，即特定的清单分支。<var></var></p>
 </li>
 </ul>
 <p class="note"><strong>注意</strong>：对于其余的所有 Repo 命令，当前工作目录必须是 <code>.repo/</code> 的父目录或相应父目录的子目录。</p>

 <h2 id="sync">sync</h2>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo sync [<var>project-list</var>]
 </pre>
 <p>下载新的更改并更新本地环境中的工作文件。如果您在未使用任何参数的情况下运行 <code>repo sync</code>，则该操作会同步所有项目的文件。</p>
 <p>运行 <code>repo sync</code> 后，将出现以下情况：</p>
 <ul>
 <li>
 <p>如果目标项目从未同步过，则 <code>repo sync</code> 相当于 <code>git clone</code>。远程代码库中的所有分支都会复制到本地项目目录中。</p>
 </li>
 <li>
 <p>如果目标项目以前同步过，则 <code>repo sync</code> 相当于以下命令：</p>
 <pre><code>git remote update
 git rebase origin/<var>branch</var>
 </code></pre>
 <p>其中 <code>branch</code> 是本地项目目录中当前已检出的分支。如果本地分支没有在跟踪远程代码库中的分支，则相应项目不会发生任何同步。</p>
 </li>
 <li>
 <p>如果 git rebase 操作导致合并冲突，请使用常规 Git 命令（例如 <code>git rebase --continue</code>）来解决冲突。</p>
 </li>
 </ul>
 <p><code>repo sync</code> 运行成功后，指定项目中的代码即处于最新状态，已与远程代码库中的代码同步。</p>
 <p>选项：</p>
 <ul>
 <li>
 <p><code>-d</code>：将指定项目切换回清单修订版本。如果项目当前属于某个主题分支，但临时需要清单修订版本，则此选项会有所帮助。</p>
 </li>
 <li>
 <p><code>-s</code>：同步到当前清单中的 manifest-server 元素指定的一个已知良好版本。<var></var></p>
 </li>
 <li>
 <p><code>-f</code>：即使某个项目同步失败，也继续同步其他项目。</p>
 </li>
 </ul>

 <h2 id="upload">upload</h2>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo upload [<var>project-list</var>]
 </pre>
 <p>对于指定的项目，Repo 会将本地分支与最后一次 repo sync 时更新的远程分支进行比较。Repo 会提示您选择一个或多个尚未上传以供审核的分支。</p>
 <p>接下来，所选分支上的所有提交都会通过 HTTPS 连接传输到 Gerrit。您需要配置一个 HTTPS 密码以启用上传授权。要生成新的用户名/密码对以用于 HTTPS 传输，请访问<a href="https://android-review.googlesource.com/new-password">密码生成器</a>。</p>
 <p>当 Gerrit 通过其服务器接收对象数据时，它会将每项提交转变成一项更改，以便审核者可以针对特定提交给出意见。要将几项“检查点”提交合并为一项提交，请使用 <code>git rebase -i</code>，然后再运行 upload。</p>
 <p>如果您在未使用任何参数的情况下运行 <code>repo upload</code>，则该操作会搜索所有项目中的更改以进行上传。</p>
 <p>要在更改上传后对其进行修改，请使用 <code>git rebase -i</code> 或 <code>git commit --amend</code> 等工具更新您的本地提交。修改完成之后，请执行以下操作：</p>
 <ul>
 <li>进行验证以确保更新后的分支是当前已检出的分支。</li>
 <li>对于相应系列中的每项提交，请在方括号内输入 Gerrit 更改 ID：<br />
 <pre><code># Replacing from branch foo
 [ 3021 ] 35f2596c Refactor part of GetUploadableBranches to lookup one specific...
 [ 2829 ] ec18b4ba Update proto client to support patch set replacments
 # Insert change numbers in the brackets to add a new patch set.
 # To create a new change record, leave the brackets empty.
 </code></pre>
 </li>
 </ul>
 <p>上传完成后，这些更改将拥有一个额外的补丁程序集。</p>
 <p>如果您希望只上传当前已检出的 Git 分支，则可以使用标记 <code>--current-branch</code> （简称 <code>--cbr</code>）。</p>

 <h2 id="diff">diff</h2>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo diff [<var>project-list</var>]
 </pre>
 <p>使用 <code>git diff</code> 显示提交与工作树之间的明显更改。</p>

 <h2 id="download">download</h2>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo download <var>target change</var>
 </pre>
 <p>从审核系统中下载指定更改，并放在您项目的本地工作目录中供使用。</p>
 <p>例如，要将<a href="https://android-review.googlesource.com/23823">更改 23823</a> 下载到您的平台/编译目录，请运行以下命令：</p>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo download platform/build 23823
 </pre>
 <p>运行 <code>repo sync</code> 应该可以移除通过 <code>repo download</code> 检索到的任何提交。或者，您可以使用 <code>git checkout m/master</code> 将远程分支检出。</p>
 <p class="note"><strong>注意</strong>：由于全球的所有服务器均存在复制延迟，因此某项更改出现在网络上（位于 <a href="https://android-review.googlesource.com/">Gerrit</a> 中）的时间与所有用户可通过 <code>repo download</code> 找到此项更改的时间之间存在些许的镜像延迟。</p>

 <h2 id="forall">forall</h2>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo forall [<var>project-list</var>] -c <var>command</var>
 </pre>
 <p>在每个项目中运行指定的 shell 命令。通过 <code>repo forall</code> 可使用下列额外的环境变量：</p>
 <ul>
 <li>
 <p><code>REPO_PROJECT</code> 设为了项目的唯一名称。</p>
 </li>
 <li>
 <p><code>REPO_PATH</code> 是相对于客户端根目录的路径。</p>
 </li>
 <li>
 <p><code>REPO_REMOTE</code> 是清单中远程系统的名称。</p>
 </li>
 <li>
 <p><code>REPO_LREV</code> 是清单中修订版本的名称，已转换为本地跟踪分支。如果您需要将清单修订版本传递到某个本地运行的 Git 命令，则可使用此变量。</p>
 </li>
 <li>
 <p><code>REPO_RREV</code> 是清单中修订版本的名称，与清单中显示的名称完全一致。</p>
 </li>
 </ul>
 <p>选项：</p>
 <ul>
 <li>
 <p><code>-c</code>：要运行的命令和参数。此命令会通过 <code>/bin/sh</code> 进行评估，它之后的任何参数都将作为 shell 位置参数传递。</p>
 </li>
 <li>
 <p><code>-p</code>：在所指定命令的输出结果之前显示项目标头。这通过以下方式实现：将管道绑定到命令的 stdin、stdout 和 sterr 流，然后通过管道将所有输出结果传输到一个分页会话中显示的连续流中。</p>
 </li>
 <li>
 <p><code>-v</code>：显示该命令向 stderr 写入的消息。</p>
 </li>
 </ul>

 <h2 id="prune">prune</h2>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo prune [<var>project-list</var>]
 </pre>
 <p>删减（删除）已合并的主题。</p>

 <h2 id="start">start</h2>
 <pre class="devsite-terminal devsite-click-to-copy">repo start
 <var>branch-name</var> [<var>project-list</var>]
 </pre>
 <p>从清单中指定的修订版本开始，创建一个新的分支进行开发。</p>
 <p><code>BRANCH_NAME</code> 参数用于简要说明您尝试对项目进行的更改。如果您不知道，则不妨考虑使用名称 <code>default</code>。</p>
 <p><code>project-list</code> 参数指定了将参与此主题分支的项目。</p>
 <p class="note"><strong>注意</strong>：句点 (.) 是一个简写形式，用来代表当前工作目录中的项目。</p>

 <h2 id="status">status</h2>
 <pre class="devsite-terminal devsite-click-to-copy">
 repo status [<var>project-list</var>]
 </pre>
 <p>对于每个指定的项目，将工作树与临时区域（索引）以及此分支 (HEAD) 上的最近一次提交进行比较。在这三种状态存在差异之处显示每个文件的摘要行。</p>
 <p>要仅查看当前分支的状态，请运行 <code>repo status</code>。系统会按项目列出状态信息。对于项目中的每个文件，系统使用两个字母的代码来表示：</p>
 <p>在第一列中，大写字母表示临时区域与上次提交状态之间的不同之处。</p>
 <table>
 <thead>
 <tr>
 <th>字母</th>
 <th>含义</th>
 <th>说明</th>
 </tr>
 </thead>
 <tbody>
 <tr>
 <td>-</td>
 <td>没有变化</td>
 <td>在 HEAD 与索引中相同</td>
 </tr>
 <tr>
 <td>A</td>
 <td>已添加</td>
 <td>不存在于 HEAD 中，但存在于索引中</td>
 </tr>
 <tr>
 <td>M</td>
 <td>已修改</td>
 <td>存在于 HEAD 中，但索引中的文件已修改</td>
 </tr>
 <tr>
 <td>D</td>
 <td>已删除</td>
 <td>存在于 HEAD 中，但不存在于索引中</td>
 </tr>
 <tr>
 <td>R</td>
 <td>已重命名</td>
 <td>不存在于 HEAD 中，索引中文件的路径已更改</td>
 </tr>
 <tr>
 <td>C</td>
 <td>已复制</td>
 <td>不存在于 HEAD 中，复制自索引中的另一个文件</td>
 </tr>
 <tr>
 <td>T</td>
 <td>模式已更改</td>
 <td>HEAD 与索引中的内容相同，但模式已更改</td>
 </tr>
 <tr>
 <td>U</td>
 <td>未合并</td>
 <td>HEAD 与索引之间存在冲突；需要加以解决</td>
 </tr>
 </tbody>
 </table>
 <p>在第二列中，小写字母表示工作目录与索引之间的不同之处。</p>
 <table>
 <thead>
 <tr>
 <th>字母</th>
 <th>含义</th>
 <th>说明</th>
 </tr>
 </thead>
 <tbody>
 <tr>
 <td>-</td>
 <td>新/未知</td>
 <td>不存在于索引中，但存在于工作树中</td>
 </tr>
 <tr>
 <td>m</td>
 <td>已修改</td>
 <td>存在于索引中，也存在于工作树中（但已修改）</td>
 </tr>
 <tr>
 <td>d</td>
 <td>已删除</td>
 <td>存在于索引中，但不存在于工作树中</td>
 </tr>
 </tbody>
 </table>

 </body></html>
	<html devsite><head>
	<title>Repo 命令参考资料</title>
	<meta name="project_path" value="/_project.yaml"/>
	<meta name="book_path" value="/_book.yaml"/>
	</head>
	<body>
	<!--
	Copyright 2017 The Android Open Source Project

	Licensed under the Apache License, Version 2.0 (the "License");
	you may not use this file except in compliance with the License.
	You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0

	Unless required by applicable law or agreed to in writing, software
	distributed under the License is distributed on an "AS IS" BASIS,
	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	See the License for the specific language governing permissions and
	limitations under the License.
	-->

	<p>使用 Repo 需遵循的格式如下：</p>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo <var>command options</var>
	</pre>
	<p>可选元素显示在方括号 [ ] 中。例如，许多命令会用到项目列表 (project-list) 参数。<var></var>项目列表可以是一个名称列表，也可以是一个本地源代码目录的路径列表：<var></var></p>
	<pre class="devsite-click-to-copy">
	<code class="devsite-terminal">repo sync [<var>project0 project1 ... projectn</var>]</code>
	<code class="devsite-terminal">repo sync [<var>/path/to/project0 ... /path/to/projectn</var>]</code>
	</pre>

	<h2 id="help">help</h2>
	<p>安装 Repo 后，您可以通过运行以下命令找到最新文档（开头是包含所有命令的摘要）：</p>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo help
	</pre>
	<p>您可以通过在 Repo 树中运行以下命令来获取有关某个命令的信息：</p>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo help <var>command</var>
	</pre>

	<p>例如，以下命令会生成 Repo <code>init</code> 参数的说明和选项列表，该参数会在当前目录中初始化 Repo（要了解详情，请参阅 <a href="#init">init</a>）。</p>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo help init
	</pre>

	<h2 id="init">init</h2>
	<pre class="devsite-terminal devsite-click-to-copy">repo init -u <var>url</var> [<var>options</var>]
	</pre>
	<p>在当前目录中安装 Repo。这会创建一个 <code>.repo/</code> 目录，其中包含用于 Repo 源代码和标准 Android 清单文件的 Git 代码库。该 <code>.repo/</code> 目录中还包含 <code>manifest.xml</code>，这是一个指向 <code>.repo/manifests/</code> 目录中所选清单的符号链接。有关更新清单的说明，请参阅 <a href="https://gerrit.googlesource.com/git-repo/+/master/docs/manifest-format.md" class="external">manifest-format.md</a>。</p>
	<p>选项：</p>
	<ul>
	<li>
	<p><code>-u</code>：指定要从中检索清单代码库的网址。您可以在 <code>https://android.googlesource.com/platform/manifest</code> 中找到通用清单</p>
	</li>
	<li>
	<p><code>-m</code>：选择代码库中的一个清单文件。如果未选择任何清单名称，则会默认选择 default.xml。</p>
	</li>
	<li>
	<p><code>-b</code>：指定修订版本，即特定的清单分支。<var></var></p>
	</li>
	</ul>
	<p class="note"><strong>注意</strong>：对于其余的所有 Repo 命令，当前工作目录必须是 <code>.repo/</code> 的父目录或相应父目录的子目录。</p>

	<h2 id="sync">sync</h2>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo sync [<var>project-list</var>]
	</pre>
	<p>下载新的更改并更新本地环境中的工作文件。如果您在未使用任何参数的情况下运行 <code>repo sync</code>，则该操作会同步所有项目的文件。</p>
	<p>运行 <code>repo sync</code> 后，将出现以下情况：</p>
	<ul>
	<li>
	<p>如果目标项目从未同步过，则 <code>repo sync</code> 相当于 <code>git clone</code>。远程代码库中的所有分支都会复制到本地项目目录中。</p>
	</li>
	<li>
	<p>如果目标项目以前同步过，则 <code>repo sync</code> 相当于以下命令：</p>
	<pre><code>git remote update
	git rebase origin/<var>branch</var>
	</code></pre>
	<p>其中 <code>branch</code> 是本地项目目录中当前已检出的分支。如果本地分支没有在跟踪远程代码库中的分支，则相应项目不会发生任何同步。</p>
	</li>
	<li>
	<p>如果 git rebase 操作导致合并冲突，请使用常规 Git 命令（例如 <code>git rebase --continue</code>）来解决冲突。</p>
	</li>
	</ul>
	<p><code>repo sync</code> 运行成功后，指定项目中的代码即处于最新状态，已与远程代码库中的代码同步。</p>
	<p>选项：</p>
	<ul>
	<li>
	<p><code>-d</code>：将指定项目切换回清单修订版本。如果项目当前属于某个主题分支，但临时需要清单修订版本，则此选项会有所帮助。</p>
	</li>
	<li>
	<p><code>-s</code>：同步到当前清单中的 manifest-server 元素指定的一个已知良好版本。<var></var></p>
	</li>
	<li>
	<p><code>-f</code>：即使某个项目同步失败，也继续同步其他项目。</p>
	</li>
	</ul>

	<h2 id="upload">upload</h2>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo upload [<var>project-list</var>]
	</pre>
	<p>对于指定的项目，Repo 会将本地分支与最后一次 repo sync 时更新的远程分支进行比较。Repo 会提示您选择一个或多个尚未上传以供审核的分支。</p>
	<p>接下来，所选分支上的所有提交都会通过 HTTPS 连接传输到 Gerrit。您需要配置一个 HTTPS 密码以启用上传授权。要生成新的用户名/密码对以用于 HTTPS 传输，请访问<a href="https://android-review.googlesource.com/new-password">密码生成器</a>。</p>
	<p>当 Gerrit 通过其服务器接收对象数据时，它会将每项提交转变成一项更改，以便审核者可以针对特定提交给出意见。要将几项“检查点”提交合并为一项提交，请使用 <code>git rebase -i</code>，然后再运行 upload。</p>
	<p>如果您在未使用任何参数的情况下运行 <code>repo upload</code>，则该操作会搜索所有项目中的更改以进行上传。</p>
	<p>要在更改上传后对其进行修改，请使用 <code>git rebase -i</code> 或 <code>git commit --amend</code> 等工具更新您的本地提交。修改完成之后，请执行以下操作：</p>
	<ul>
	<li>进行验证以确保更新后的分支是当前已检出的分支。</li>
	<li>对于相应系列中的每项提交，请在方括号内输入 Gerrit 更改 ID：<br />
	<pre><code># Replacing from branch foo
	[ 3021 ] 35f2596c Refactor part of GetUploadableBranches to lookup one specific...
	[ 2829 ] ec18b4ba Update proto client to support patch set replacments
	# Insert change numbers in the brackets to add a new patch set.
	# To create a new change record, leave the brackets empty.
	</code></pre>
	</li>
	</ul>
	<p>上传完成后，这些更改将拥有一个额外的补丁程序集。</p>
	<p>如果您希望只上传当前已检出的 Git 分支，则可以使用标记 <code>--current-branch</code> （简称 <code>--cbr</code>）。</p>

	<h2 id="diff">diff</h2>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo diff [<var>project-list</var>]
	</pre>
	<p>使用 <code>git diff</code> 显示提交与工作树之间的明显更改。</p>

	<h2 id="download">download</h2>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo download <var>target change</var>
	</pre>
	<p>从审核系统中下载指定更改，并放在您项目的本地工作目录中供使用。</p>
	<p>例如，要将<a href="https://android-review.googlesource.com/23823">更改 23823</a> 下载到您的平台/编译目录，请运行以下命令：</p>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo download platform/build 23823
	</pre>
	<p>运行 <code>repo sync</code> 应该可以移除通过 <code>repo download</code> 检索到的任何提交。或者，您可以使用 <code>git checkout m/master</code> 将远程分支检出。</p>
	<p class="note"><strong>注意</strong>：由于全球的所有服务器均存在复制延迟，因此某项更改出现在网络上（位于 <a href="https://android-review.googlesource.com/">Gerrit</a> 中）的时间与所有用户可通过 <code>repo download</code> 找到此项更改的时间之间存在些许的镜像延迟。</p>

	<h2 id="forall">forall</h2>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo forall [<var>project-list</var>] -c <var>command</var>
	</pre>
	<p>在每个项目中运行指定的 shell 命令。通过 <code>repo forall</code> 可使用下列额外的环境变量：</p>
	<ul>
	<li>
	<p><code>REPO_PROJECT</code> 设为了项目的唯一名称。</p>
	</li>
	<li>
	<p><code>REPO_PATH</code> 是相对于客户端根目录的路径。</p>
	</li>
	<li>
	<p><code>REPO_REMOTE</code> 是清单中远程系统的名称。</p>
	</li>
	<li>
	<p><code>REPO_LREV</code> 是清单中修订版本的名称，已转换为本地跟踪分支。如果您需要将清单修订版本传递到某个本地运行的 Git 命令，则可使用此变量。</p>
	</li>
	<li>
	<p><code>REPO_RREV</code> 是清单中修订版本的名称，与清单中显示的名称完全一致。</p>
	</li>
	</ul>
	<p>选项：</p>
	<ul>
	<li>
	<p><code>-c</code>：要运行的命令和参数。此命令会通过 <code>/bin/sh</code> 进行评估，它之后的任何参数都将作为 shell 位置参数传递。</p>
	</li>
	<li>
	<p><code>-p</code>：在所指定命令的输出结果之前显示项目标头。这通过以下方式实现：将管道绑定到命令的 stdin、stdout 和 sterr 流，然后通过管道将所有输出结果传输到一个分页会话中显示的连续流中。</p>
	</li>
	<li>
	<p><code>-v</code>：显示该命令向 stderr 写入的消息。</p>
	</li>
	</ul>

	<h2 id="prune">prune</h2>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo prune [<var>project-list</var>]
	</pre>
	<p>删减（删除）已合并的主题。</p>

	<h2 id="start">start</h2>
	<pre class="devsite-terminal devsite-click-to-copy">repo start
	<var>branch-name</var> [<var>project-list</var>]
	</pre>
	<p>从清单中指定的修订版本开始，创建一个新的分支进行开发。</p>
	<p><code>BRANCH_NAME</code> 参数用于简要说明您尝试对项目进行的更改。如果您不知道，则不妨考虑使用名称 <code>default</code>。</p>
	<p><code>project-list</code> 参数指定了将参与此主题分支的项目。</p>
	<p class="note"><strong>注意</strong>：句点 (.) 是一个简写形式，用来代表当前工作目录中的项目。</p>

	<h2 id="status">status</h2>
	<pre class="devsite-terminal devsite-click-to-copy">
	repo status [<var>project-list</var>]
	</pre>
	<p>对于每个指定的项目，将工作树与临时区域（索引）以及此分支 (HEAD) 上的最近一次提交进行比较。在这三种状态存在差异之处显示每个文件的摘要行。</p>
	<p>要仅查看当前分支的状态，请运行 <code>repo status</code>。系统会按项目列出状态信息。对于项目中的每个文件，系统使用两个字母的代码来表示：</p>
	<p>在第一列中，大写字母表示临时区域与上次提交状态之间的不同之处。</p>
	<table>
	<thead>
	<tr>
	<th>字母</th>
	<th>含义</th>
	<th>说明</th>
	</tr>
	</thead>
	<tbody>
	<tr>
	<td>-</td>
	<td>没有变化</td>
	<td>在 HEAD 与索引中相同</td>
	</tr>
	<tr>
	<td>A</td>
	<td>已添加</td>
	<td>不存在于 HEAD 中，但存在于索引中</td>
	</tr>
	<tr>
	<td>M</td>
	<td>已修改</td>
	<td>存在于 HEAD 中，但索引中的文件已修改</td>
	</tr>
	<tr>
	<td>D</td>
	<td>已删除</td>
	<td>存在于 HEAD 中，但不存在于索引中</td>
	</tr>
	<tr>
	<td>R</td>
	<td>已重命名</td>
	<td>不存在于 HEAD 中，索引中文件的路径已更改</td>
	</tr>
	<tr>
	<td>C</td>
	<td>已复制</td>
	<td>不存在于 HEAD 中，复制自索引中的另一个文件</td>
	</tr>
	<tr>
	<td>T</td>
	<td>模式已更改</td>
	<td>HEAD 与索引中的内容相同，但模式已更改</td>
	</tr>
	<tr>
	<td>U</td>
	<td>未合并</td>
	<td>HEAD 与索引之间存在冲突；需要加以解决</td>
	</tr>
	</tbody>
	</table>
	<p>在第二列中，小写字母表示工作目录与索引之间的不同之处。</p>
	<table>
	<thead>
	<tr>
	<th>字母</th>
	<th>含义</th>
	<th>说明</th>
	</tr>
	</thead>
	<tbody>
	<tr>
	<td>-</td>
	<td>新/未知</td>
	<td>不存在于索引中，但存在于工作树中</td>
	</tr>
	<tr>
	<td>m</td>
	<td>已修改</td>
	<td>存在于索引中，也存在于工作树中（但已修改）</td>
	</tr>
	<tr>
	<td>d</td>
	<td>已删除</td>
	<td>存在于索引中，但不存在于工作树中</td>
	</tr>
	</tbody>
	</table>

	</body></html>