一、命令行 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 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 "在此处键入您的信息"
请参见分支和合并。