使用命令行 Subversion 访问项目源文件（SVN）

from:http://www.open.collab.net/scdocs/ddUsingSVN_command-line.html.zh-cn

命令行 Subversion 入门

若是您参与的项目正在使用 Subversion 进行版本控制，您将须要使用 Subversion 访问和更改项目源文件。您能够点击项目的左侧导航窗格上的“Subversion”连接，在线浏览源代码以查看该项目的目录结构和文件。

“Subversion”页面显示三个子目录：branches/、tags/、trunk/ 和一个自述文件。自述文件可使您对 Subversion 存储库有一个总体了解。您能够点击“访问选项”，查看 Subversion 客户端安装说明。您的本地计算机上必须安装有 Subversion 客户端。

获取项目的本地工做副本：svn checkout

若要获取最新源文件的“工做副本”，您必须首先签出这些源文件，这一过程会将文件从存储库复制到您的系统中。在您的外壳程序或终端客户端，请键入：

svn checkout https://(项目名称).(域)/svn/(项目名称)/(DIR) (项目名称) --username [在此处输入用户名]

当系统提示您时输入您的用户密码。此密码应与您在本站点中的用户账号的密码相同。不指定目录将签出整个项目源代码。您可能但愿签出“trunk/”目录，由于此目录具备工做“www/”文件夹。

转换：--revision (-r) REV, --quiet (-q), --non-recursive (-N), --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR

请参见基本工做周期、初始签出、工做副本。

注意：若是站点未启用 SSL（安全套接字层），则在执行 Subversion 操做时，请使用 http 而不是 https。例如，若要从项目的存储库中签出最新的源代码，请使用如下命令：

svn checkout https://(项目名称).(域)/svn/(项目名称)/(DIR) (项目名称) --username [在此处输入用户名]

处理 Subversion 存储库中的文件

从项目存储库中签出本地副本后，您能够在本地计算机上编辑现有文件、建立新文件和目录、以及删除文件。在您将所作的任何更改提交回 Subversion 存储库以前，这些更改只对项目文件的本地副本起做用。

将工做副本中的文件/目录添加到存储库中：svn add

在您第一次在工做目录中建立并编辑新文件后，能够将此文件添加到存储库中，或添加一个目录，目录中有无内容都可。

svn add FILENAME/DIR。

这样就会在您的工做副本中添加文件/目录，并安排它们以添加到存储库中。您下次提交时，会上载这些文件/目录，并将它们添加到存储库中。若是您了添加内容，但在提交前又改变了主意，则可使用 svn revert 取消添加内容的安排。

转换：--targets FILENAME, --non-recursive (-N), --quiet (-q), --config-dir arg, --auto-props, --no-auto-props

请参见添加文件/目录示例。

查看带有修订和做者信息的特定文件的内容：svn blame

若要在线查看指定文件的做者和修订信息，请键入：

svn blame FILENAME

每行文本的开始处都以上次更改该行的做者（用户名）和修订版本号做为批注。

转换：--revision (-r) REV, --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR

查看特定文件的内容：svn cat

有时，与存储库相比较，您的工做副本可能已过期；或者您可能已修改了本地工做副本。在这些状况下，在提交更改或决定编辑您的工做副本以前，您会但愿查看指定文件的内容差别。运行 svn cat FILENAME 将自动从存储库中取出 HEAD 修订版本。这条子命令主要用于检索具备较旧修订版本号的文件，并将其显示在屏幕上。经过在此站点上浏览项目源代码，也能够执行相同的操做。

转换：--revision (-r) REV, --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR

清理工做副本：svn cleanup

有时可能会出现“工做副本已锁定”错误。若要删除锁定，并递归清理工做副本，请使用 svn update。

转换：--diff3-cmd CMD, --config-dir DIR

请参见 svn cleanup。

复制工做副本或存储库中的文件或目录：svn copy

在项目中，您可能须要用到过去的旧文档。例如，您可能想要使用一个已存在的 HTML 文件，使用其代码做为参考以在建立新内容时保持产品外观和感受。建立文件时，您无需从头开始，只需使用 svn copy 复制此文件，而后将其另存为其它名称并更改其内容。您能够从存储库将文件复制为本地工做副本，也能够将本地工做副本复制回存储库文件。您还能够在本地工做副本内部复制文件。Subversion 不支持在存储库之间进行复制。可以使用 svn copy SRC DST 完成此操做。

转换：--message (-m) TEXT, --file (-F) FILE, --revision (-r) REV, --quiet (-q), --username USER, --password PASS, --no-auth-cache, --non-interactive, --force-log, --editor-cmd EDITOR, --encoding ENC, --config-dir DIR

请参见 svn copy。

从本地工做副本中删除文件或目录：svn delete

您可能但愿从本地工做副本中删除不须要的文件。使用 svn delete FILENAME 可安排删除文件。仅当您提交时，才会在存储库中将该文件实际删除。

转换：--force, --force-log, --message (-m) TEXT, --file (-F) FILE, --quiet (-q), --targets FILENAME, --username USER, --password PASS, --no-auth-cache, --non-interactive, --editor-cmd EDITOR, --encoding ENC, --config-dir DIR

查看文件之间的差别：svn diff

可使用 svn diff 显示工做副本中的指定文件相对于存储库中相应文件所作的本地修改。在命令提示符处，请键入：

svn diff (文件的路径) (项目存储库的 URL)

例如，若要将本地修改后的文件“index.html”与项目存储库中的相应文件进行比较，请键入：

svn diff $SRC/...../index.html https://(项目名称).(域)/svn/(项目名称)/trunk (项目名称) --username [在此处输入用户名]

除此以外，您也能够转到该文件所属的目录，并键入：

svn diff (FILENAME)

该命令将显示差别，而且带有修订版本号。

转换：--revision (-r) REV, --old OLD-TARGET, --new NEW-TARGET, --extensions (-x) "ARGS", --non-recursive (-N), --diff-cmd CMD, --notice-ancestry, --username USER, --password PASS, --no-auth-cache, --non-interactive, --no-diff-deleted, --config-dir DIR

请参见检查历史、svn diff。

在本地计算机上导出空目录树：svn export

在您的本地计算机上，能够从项目存储库或本地工做副本内部提取一个无版本的副本，也称为空目录树。若要从存储库中得到较旧修订版本的空目录，请键入：

svn export [-r REV] [PATH]

该命令将从 URL 指定的存储库中的修订版本 REV 位置（若是指定，不然从 HEAD 位置）将空目录树导出到 PATH。如省略 PATH，则该 URL 的最后一部分将用做本地目录名称。除此以外，您也能够在本地计算机内部，从一个工做副本（由 PATH1 指定）向另外一工做副本（由 PATH2 指定）导出空目录树。这将保留全部的本地更改，但不会复制版本控制中的文件。若要执行此操做，请键入：

svn export PATH1 PATH2

转换：--revision (-r) REV, --quiet (-q), --force, --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR

获取有关 Subversion 的帮助：svn help

Subversion 能够在命令行界面为您提供帮助。若要得到有关特定子命令的帮助，请键入：

svn help [SUBCOMMAND...]

转换：--version, --quiet (-q)

将您的更改提供给 SVN 存储库

对文件和/或目录进行本地更改后，您必须向 SVN 存储库提交这些更改。

提交您的更改：svn commit

若要向共享存储库提交您的更改，请键入：

svn commit -m "请在此处键入您的理由"

若是您不包括对该文件更改的描述，系统将提示您调用文件编辑器添加描述，而后 svn 才能完成提交操做；不然将会出现“提交失败”错误。全部的提交都会被自动记录，并发布到项目的提交讨论中。

转换：--message (-m) TEXT, --file (-F) FILE, --quiet (-q), --non-recursive (-N), --targets FILENAME, --force-log, --username USER, --password PASS, --no-auth-cache, --non-interactive, --encoding ENC, --config-dir DIR

请参见提交您的更改、editor-cmd。

将无版本的文件或树导入到项目存储库中：svn import

您可使用 svn import 将无版本的文件或树递归提交到项目存储库中。将根据须要在存储库中建立父目录。使用下面的命令能够从 PATH 向 URL 递归提交副本。若是省略 PATH，将认为其为“.”。

svn import [PATH] URL

示例：若要在您的本地计算机上建立带有一个文件的无版本目录 (D)。请点击项目左侧导航窗格中的“Subversion”连接，找到 Subversion 页面。请注意，“浏览源代码”下未列出 NEWDIR。若要将 D 导入项目存储库，请键入：

svn import -m "请在此处键入您的信息" D http://(项目名称).(域)/svn/(项目名称)/NEWDIR

刷新该页面。请注意，此时“浏览源代码”下列出了 D。点击 D 查看该文件。

转换：--message (-m) TEXT, --file (-F) FILE, --quiet (-q), --non-recursive (-N), --username USER, --password PASS, --no-auth-cache, --non-interactive, --force-log, --editor-cmd EDITOR, --encoding ENC, --config-dir DIR, --auto-props, --no-auto-props

打印有关工做副本中路径的信息：svn info

有时，您将须要有关工做副本中文件的具体信息，以执行某些子命令。键入 svn info，将打印出详尽且有用的信息，这些信息涉及工做副本中的工做副本路径中的项，其中包括：路径、名称、URL、修订版本、节点类型、上次更改、做者、上次更改修订版本、上次更改日期、上次更新的文本、上次更新的属性以及校验和。

转换：--targets FILENAME, --recursive (-R), --config-dir DIR

查看存储库中的目录项列表：svn list

在开始处理项目或取出“工做副本”以前，您可能但愿查看项目存储库中的内容（即目录和文件），或查看本地工做副本中的目录项。在命令提示符处键入 svn list [TARGET...]，也能够查看这些内容。除此以外，您也能够找到项目中的“软件配置管理”页，查看项目存储库。

转换：--revision (-r) REV, --verbose (-v), --recursive (-R), --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR

查看提交日志信息：svn log

若是要查看“工做副本”或存储库中文件/目录的各个文件/目录历史，以跟踪修订信息，请键入：

svn log [PATH]

该命令会显示出文件/目录的修订信息，从最近所作的修订版本开始显示提交信息和做者姓名等信息。除此以外，您也可使用该站点，查看项目存储库中各个文件的提交日志信息。请点击项目左侧导航窗格中的“Subversion”连接。将出现 Subversion 页。搜索“浏览源代码”的目录中的文件，而后点击文件名。这时将会显示一个提交日志信息页面。

转换：--revision (-r) REV, --quiet (-q), --verbose (-v), --targets FILENAME, --stop-on-copy, --incremental, --xml, --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR

请参见 svn log。

合并更改：svn merge

您能够运行 svn merge 命令，以指示 Subversion 将存储库中最新版本的文件合并到您的工做副本中。

转换：--revision (-r) REV, --non-recursive (-N), --quiet (-q), --force, --dry-run, --diff3-cmd CMD, --ignore-ancestry, --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR

请参见 svn merge、解决冲突（合并其余人的更改）、分支和合并：常见合并使用案例、合并最佳实践。

使用存储库

建立新目录：svn mkdir

若要在您的工做副本中建立新目录，请键入：

svn mkdir PATH

若要在您的项目存储库中建立新目录，请键入：

svn mkdir URL

PATH 或 URL 的最后一部分决定目录名称。在当即提交时在存储库中建立目录，因此还须要一条提交信息

转换：--message (-m) TEXT, --file (-F) FILE, --quiet (-q), --username USER, --password PASS, --no-auth-cache, --non-interactive, --editor-cmd EDITOR, --encoding ENC, --force-log, --config-dir DIR

移动文件或目录：svn move

您可使用 svn move SRC DST 在工做副本或项目存储库内部移动文件或目录。此命令等效于在使用 svn copy 后，再使用 svn delete。在工做副本内部移动文件或目录，不只会移动该文件或目录，并且还将安排它以便于下次提交时进行添加。在项目存储库内部移动文件或目录属于封闭单元式提交，因此须要一条提交信息。

转换：--message (-m) TEXT, --file (-F) FILE, --revision (-r) REV, --quiet (-q), --force, --username USER, --password PASS, --no-auth-cache, --non-interactive, --editor-cmd EDITOR, --encoding ENC, --force-log, --config-dir DIR

使用属性

Subversion 具备不少具体属性，这些属性影响或决定其行为。您能够修改、提交和撤消属性更改，就像对文件内容所执行的操做同样。您还能够从本地工做副本或项目存储库的文件、目录或修订版本中，删除、编辑、打印、列出以及设置属性。

请参见 属性、无版本属性、元数据属性、svn propdel、svn propedit、svn propget、svn proplist、svn propset、Hook 脚本。

解决冲突：svn resolved

更新本地工做副本时，可能会遇到冲突。您须要解决此冲突。解决冲突后，键入 svn resolved PATH...，通知工做副本该冲突已“解决”。

转换：--targets FILENAME, --recursive (-R), --quiet (-q), --config-dir DIR

请参见解决冲突（合并其余人的更改）。

撤消您的更改：svn revert

使用 Subversion 时，您会发现 svn revert PATH... 等效于 Windows 中的 Ctrl Z。您能够：

• 撤消本地工做副本中的任何本地更改，从而解决冲突状态。
• 撤消工做副本中的条目内容及属性更改。
• 取消任何进度安排操做，如添加文件、删除文件等。

注意，如不提供目标，会致使工做副本中的更改丢失。

转换：--targets FILENAME, --recursive (-R), --quiet (-q), --config-dir DIR

获取文件/目录的状态：svn status

在版本控制中，将更改提交到项目存储库以前最好对其进行审查。能够运行 svn status 打印工做副本中的文件和目录的状态。打印结果为八列编码输出。因为每列都有详尽的图例，若要今后输出中得出“无错误”的结论几乎不可能。若要使此任务更加简单，并同时可看到示例，请在命令提示符处键入 svn help status。

转换：--show-updates (-u), --verbose (-v), --non-recursive (-N), --quiet (-q), --no-ignore, --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir

请参见检查你的更改。

转换工做副本：svn switch

可使用 svn switch URL [PATH] 更新工做副本，以镜像新的 URL。您还能够将工做副本或部分工做副本移动到新的分支。您能够将此子命令用做分支的快捷方式。

转换：--revision (-r) REV, --non-recursive (-N), --quiet (-q), --diff3-cmd CMD, --relocate, --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR

请参见转换工做副本、分支和合并以及 svn switch。

更新工做副本：svn update

为了进行更好的版本控制，建议您天天用项目存储库更新本地工做副本，请使用：

svn update [PATH...]

列出的已更新条目以及它们的当前状态显示以下：

• A = 已将一个文件添加到您的工做副本中。
• U = 已更新您的工做副本中的一个文件。
• D = 已从您的工做副本中删除一个文件。
• R = 已替换您的工做副本中的一个文件。
• G = 已成功合并了一个文件。
• C = 一个文件已合并了必须手动解决的冲突

转换：--revision (-r) REV, --non-recursive (-N), --quiet (-q), --diff3-cmd CMD, --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR

请参见更新你的工做副本、手动合并冲突。

分支和标记

项目的主干一般用做开发主线，而分支一般用做主线的变动。分支是正在进行的开发线。在软件开发生命周期中，若是软件产品的发布版本已到期，常常 会用到分支，使测试者可使用候选版本，使新的开发能够继续进行，不受测试的约束。分支还用于实验性工做，以及完成代码重写。标记是将一组文件修订版本标 记为总体的方式。虽然分支和标记都是使用 svn copy 子命令建立的，但它们是彻底不一样的。分支表示多个修订版本而标记只表示单个修订版本。

本站点上您项目的 Subversion 存储库支持对您的源文件进行分支和标记。对于 Subversion 来讲，标记和分支属于简单实用的“复制”操做。

若要建立分支或标记项目文件，请键入：

svn copy SRC DST -m "在此处键入您的信息"

请参见分支和合并。