本章是使用Subversion的一个完全手册，包括了命令行客户端（svn）和它的所有子命令，也有版本库管理程序（svnadmin和svnlook）和它们各自的子命令。 为了使用命令行客户端，只需要输入svn和它的子命令 是的，使用--version选项不需要子命令，几分钟后我们会到达那个部分。 以及相关的选项或操作的对象—输入的子命令和选项没有特定的顺序，下面使用svn status的方式都是合法的： $ svn -v status $ svn status -v $ svn status -v myfile 你可以在发现更多使用客户端命令的例子，以及中的管理属性的命令。 虽然Subversion的子命令有一些不同的选项，但有的选项是全局的—也就是说，每个选项保证是表示同样的事情，而不管是哪个子命令使用的。举个例子，--verbose（-v）一直意味着冗长输出，而不管使用它的命令是什么。 --auto-props 开启auto-props，覆盖config文件中的enable-auto-props指示。 --config-dir DIR 指导Subversion从指定目录而不是默认位置（用户主目录的.subversion）读取配置信息。 --diff-cmd CMD 指定用来表示文件区别的外部程序，当svn diff调用时，会使用Subversion的内置区别引擎，默认会提供统一区别输出，如果你希望使用一个外置区别程序，使用--diff-cmd。你可以通过--extensions（本小节后面有更多介绍）把选项传递到区别程序。 --diff3-cmd CMD 指定一个外置程序用来合并文件。 --dry-run 检验运行一个命令的效果，但没有实际的修改—可以用在磁盘和版本库。 --editor-cmd CMD 指定一个外部程序来编辑日志信息或是属性值。如何设定缺省编辑器见的editor-cmd小节。 --encoding ENC 告诉Subversion你的提交日志信息是通过提供的字符集编码的，缺省时是你的操作系统的本地编码，如果你的提交信息使用其它编码，你一定要指定这个值。 --extensions (-x) ARGS 指定一个或多个Subversion传递给提供文件区别的外部区别程序的参数，如果你要传递多个参数，你一定能够要用引号（例如，svn diff --diff-cmd /usr/bin/diff -x "-b -E"）括起所有的参数。这个选项只有在使用--diff-cmd选项时使用。 --file (-F) FILENAME 使用传递的文件内容作为特定子命令的选项。 --force 强制一个特定的命令或操作运行。Subversion有一些操作防止你做普通的使用，但是你可以传递force选项告诉Subversion我知道我做的事情，也知道这样的结果，所以让我做吧。这个选项在程序上等同于在打开电源的情况下做你自己的电子工作—如果你不知道你在做什么，你很有可能会得到一个威胁的警告。 --force-log 将传递给--message（-m）或者--file（-F）的可疑参数指定为有效可接受。缺省情况下，如果选项的参数看起来会成为子命令的目标，Subversion会提出一个错误，例如，你传递一个版本化的文件路径给--file（-F）选项，Subversion会认为出了点错误，认为你将目标对象当成了参数，而你并没有提供其它的—未版本化的文件作为日志信息的文件。为了确认你的意图并且不考虑这类错误，传递--force-log选项给命令来接受它作为日志信息。 --help (-h或-?) 如果同一个或多个子命令一起使用，会显示每个子命令内置的帮助文本，如果单独使用，它会显示常规的客户端帮助文本。 --ignore-ancestry 告诉Subversion在计算区别（只依赖于路径内容）时忽略祖先。 --ignore-externals 告诉Subversion忽略外部定义和外部定义管理的工作拷贝。 --incremental 打印适合串联的输出格式。 --limit NUM 只显示第一个NUM日志信息。 --message (-m) MESSAGE 表示你会在命令行中指定日志信息，紧跟这个开关，例如： $ svn commit -m "They don't make Sunday." --new ARG 使用ARG作为新的目标。 --no-auth-cache 阻止在Subversion管理区缓存认证信息（如用户名密码）。 --no-auto-props 关闭auto-props，覆盖config文件中的enable-auto-props指示。 --no-diff-added 防止Subversion打印添加文件的区别。缺省的行为方式是，当添加一个文件时，svn diff打印的信息和比较一个空白文件相同。 --no-diff-deleted 防止Subversion打印删除文件的区别信息，缺省的行为方式是当你删除了一个文件后运行svn diff打印的区别与删除文件所有的内容得到的结果一样。 --no-ignore 在状态列表中显示global-ignores配置选项或者是svn:ignore属性忽略的文件。见和查看详情。 --no-unlock 不自动解锁文件（缺省的提交行为是解锁提交列出的所有文件），更多信息见。 --non-interactive 如果认证失败，或者是不充分的凭证时，防止出现要求凭证的提示（例如用户名和密码）。这在运行自动脚本时非常有用，只是让Subversion失败而不是提示更多的信息。 --non-recursive (-N) 防止子命令迭代到子目录，大多数子命令缺省是迭代的，但是一些子命令—通常是那些潜在的删除或者是取消本地修改的命令—不是。 --notice-ancestry 在计算区别时关注祖先。 --old ARG 使用ARG作为旧的目标。 --password PASS 指出在命令行中提供你的密码—另外，如果它是需要的，Subversion会提示你输入。 --quiet (-q) 请求客户端在执行操作时只显示重要信息。 --recursive (-R) 让子命令迭代到子目录，大多数子命令缺省是迭代的。 --relocate 目的路径[PATH...] svn switch子命令中使用，用来修改你的工作拷贝所引用的版本库位置。当版本库的位置修改了，而你有一个工作拷贝，希望继续使用时非常有用。见svn switch的例子。 --revision (-r) REV 指出你将为特定操作提供一个修订版本（或修订版本的范围），你可以提供修订版本号，修订版本关键字或日期（在华括号中）作为修订版本开关的参数。如果你希望提供一个修订版本范围，你可以提供用冒号隔开的两个修订版本，举个例子： $ svn log -r 1729 $ svn log -r 1729:HEAD $ svn log -r 1729:1744 $ svn log -r {2001-12-04}:{2002-02-17} $ svn log -r 1729:{2002-02-17} 见查看更多信息。 --revprop 操作是针对一个修订版本的属性而不是一个文件或目录的属性。这个开关需要你也要通过--revision（-r）传递一个修订版本号，见关于未版本化的属性的细节。 --show-updates (-u) 导致客户端显示本地拷贝哪些文件已经过期，这不会实际更新你的任何文件—只是显示了如果你运行svn update时更新的文件。 --stop-on-copy 导致Subversion子命令在传递历史时会在版本化资源拷贝时停止收集历史信息—也就是历史中资源从另一个位置拷贝过来时。 --strict 导致Subversion使用严格的语法，也就是选择含糊，除非谈论特定的子命令。 --targets FILENAME 告诉Subversion从你提供的文件中得到希望操作的文件列表，而不是在命令行列出所有的文件。 --username NAME 表示你要在命令行提供认证的用户名—否则如果需要，Subversion会提示你这一点。 --verbose (-v) 请求客户端在运行子命令打印尽量多的信息，会导致Subversion打印额外的字段，每个文件的细节信息或者是关于动作的附加信息。 --version 打印客户端版本信息，这个信息不仅仅包括客户端的版本号，也有所有客户端可以用来访问Subversion版本库的版本库访问模块列表。 --xml 使用XML格式打印输出。 svn add 添加文件、目录或符号链。 svn add PATH... 添加文件、目录或符号链到你的工作拷贝并且预定添加到版本库。它们会在下次提交上传并添加到版本库，如果你在提交之前改变了主意，你可以使用svn revert取消预定。 无 工作拷贝 否 --targets FILENAME --non-recursive (-N) --quiet (-q) --config-dir DIR --auto-props --no-auto-props --force 添加一个文件到工作拷贝： $ svn add foo.c A foo.c 当添加一个目录，svn add缺省的行为方式是递归的： $ svn add testdir A testdir A testdir/a A testdir/b A testdir/c A testdir/d 你可以只添加一个目录而不包括其内容： $ svn add --non-recursive otherdir A otherdir 通常情况下，命令svn add *会忽略所有已经在版本控制之下的目录，有时候，你会希望添加所有工作拷贝的未版本化文件，包括那些隐藏在深处的文件，可以使用svn add的--force递归到版本化的目录下： $ svn add * --force A foo.c A somedir/bar.c A otherdir/docs/baz.doc … svn blame 显示特定文件和URL内嵌的作者和修订版本信息。 svn blame TARGET[@REV]... 显示特定文件和URL内嵌的作者和修订版本信息。每一行文本在开头都放了最后修改的作者（用户名）和修订版本号。 praise、annotate、ann 无 是 --revision (-r) REV --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR --verbose 如果你希望在测试版本库看到blame标记的readme.txt源代码： $ svn blame http://svn.red-bean.com/repos/test/readme.txt 3 sally This is a README file. 5 harry You should read this. svn cat 输出特定文件或URL的内容。 svn cat TARGET[@REV]... 输出特定文件或URL的内容。列出目录的内容可以使用svn list。 无 无 是 --revision (-r) REV --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR 如果你希望不检出而察看版本库的readme.txt的内容： $ svn cat http://svn.red-bean.com/repos/test/readme.txt This is a README file. You should read this. 如果你的工作拷贝已经过期（或者你有本地修改），并且希望察看工作拷贝的HEAD修订版本的一个文件，如果你给定一个路径，svn cat会自动取得HEAD的修订版本： $ cat foo.c This file is in my local working copy and has changes that I've made. $ svn cat foo.c Latest revision fresh from the repository! svn checkout 从版本库取出一个工作拷贝。 svn checkout URL[@REV]... [PATH] 从版本库取出一个工作拷贝，如果省略PATH，URL的基名称会作为目标，如果给定多个URL，每一个都会检出到PATH的子目录，使用URL基名称的子目录名称。 co 创建一个工作拷贝。 是 --revision (-r) REV --quiet (-q) --non-recursive (-N) --username USER --password PASS --no-auth-cache --non-interactive --ignore-externals --config-dir DIR 取出一个工作拷贝到mine： $ svn checkout file:///tmp/repos/test mine A mine/a A mine/b Checked out revision 2. $ ls mine 检出两个目录到两个单独的工作拷贝： $ svn checkout file:///tmp/repos/test file:///tmp/repos/quiz A test/a A test/b Checked out revision 2. A quiz/l A quiz/m Checked out revision 2. $ ls quiz test 检出两个目录到两个单独的工作拷贝，但是将两个目录都放到working-copies： $ svn checkout file:///tmp/repos/test file:///tmp/repos/quiz working-copies A working-copies/test/a A working-copies/test/b Checked out revision 2. A working-copies/quiz/l A working-copies/quiz/m Checked out revision 2. $ ls working-copies 如果你打断一个检出（或其它打断检出的事情，如连接失败。），你可以使用同样的命令重新开始或者是更新不完整的工作拷贝： $ svn checkout file:///tmp/repos/test test A test/a A test/b ^C svn: The operation was interrupted svn: caught SIGINT $ svn checkout file:///tmp/repos/test test A test/c A test/d ^C svn: The operation was interrupted svn: caught SIGINT $ cd test $ svn update A test/e A test/f Updated to revision 3. svn cleanup 递归清理工作拷贝。 svn cleanup [PATH...] 递归清理工作拷贝，删除未完成的工作拷贝锁定，并恢复未完成的操作。如果你得到一个工作拷贝已锁定的错误，运行这个命令可以删除无效的锁定，让你的工作拷贝再次回到可用的状态。 如果，因为一些原因，运行外置的区别程序（例如，用户输入或是网络错误）有时候会导致一个svn update失败，使用--diff3-cmd选项可以完全清除你的外置区别程序所作的合并，你也可以使用--config-dir指定任何配置目录，但是你应该不会经常使用这些选项。 无 工作拷贝 否 --diff3-cmd CMD --config-dir DIR svn cleanup没有输出，没有太多的例子，如果你没有传递PATH，会使用.。 $ svn cleanup $ svn cleanup /path/to/working-copy svn commit 将修改从工作拷贝发送到版本库。 svn commit [PATH...] 将修改从工作拷贝发送到版本库。如果你没有使用--file或--message提供一个提交日志信息，svn会启动你的编辑器来编写一个提交信息，见的editor-cmd小节。 svn commit will send found lock tokens and release locks on all PATHS committed (recursively) unless --no-unlock is passed. 如果你开始一个提交并且Subversion启动了你的编辑器来编辑提交信息，你仍可以退出而不会提交你的修改，如果你希望取消你的提交，只需要退出编辑器而不保存你的提交信息，Subversion会提示你是选择取消提交、空信息继续还是重新编辑信息。 ci（check in的缩写；不是checkout的缩写co。） 工作拷贝，版本库 是 --message (-m) TEXT --file (-F) FILE --quiet (-q) --no-unlock --non-recursive (-N) --targets FILENAME --force-log --username USER --password PASS --no-auth-cache --non-interactive --encoding ENC --config-dir DIR 使用命令行提交一个包含日志信息的文件修改，当前目录（.）是没有说明的目标路径： $ svn commit -m "added howto section." Sending a Transmitting file data . Committed revision 3. 提交一个修改到foo.c（在命令行明确指明），并且msg文件中保存了提交信息： $ svn commit -F msg foo.c Sending foo.c Transmitting file data . Committed revision 5. 如果你希望使用在--file选项中使用在版本控制之下的文件作为参数，你需要使用--force-log选项： $ svn commit --file file_under_vc.txt foo.c svn: The log message file is under version control svn: Log message file is a versioned file; use '--force-log' to override $ svn commit --force-log --file file_under_vc.txt foo.c Sending foo.c Transmitting file data . Committed revision 6. 提交一个已经预定要删除的文件： $ svn commit -m "removed file 'c'." Deleting c Committed revision 7. svn copy 拷贝工作拷贝的一个文件或目录到版本库。 svn copy SRC DST 拷贝工作拷贝的一个文件或目录到版本库。SRC和DST既可以是工作拷贝（WC）路径也可以是URL： WC -> WC 拷贝并且预定一个添加的项目（包含历史）。 WC -> URL 将WC或URL的拷贝立即提交。 URL -> WC 检出URL到WC，并且加入到添加计划。 URL -> URL 完全的服务器端拷贝，通常用在分支和标签。 你只可以在单个版本库中拷贝文件，Subversion还不支持跨版本库的拷贝。 cp 如果目标是URL则包括版本库。 如果目标是WC路径，则是工作拷贝。 如果目标是版本库，或者需要查看修订版本号，则会访问版本库。 --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 foo.txt bar.txt A bar.txt $ svn status A + bar.txt 拷贝你的工作拷贝的一个项目到版本库的URL（直接的提交，所以需要提供一个提交信息）： $ svn copy near.txt file:///tmp/repos/test/far-away.txt -m "Remote copy." Committed revision 8. 拷贝版本库的一个项目到你的工作拷贝（只是预定要拷贝—在提交之前不会影响版本库）： 这是恢复死掉文件的推荐方式！ $ svn copy file:///tmp/repos/test/far-away near-here A near-here 最后，是在URL之间拷贝： $ svn copy file:///tmp/repos/test/far-away file:///tmp/repos/test/over-there -m "remote copy." Committed revision 9. 这是在版本库里作标签最简单的方法—svn copy那个修订版本（通常是HEAD）到你的tags目录。 $ svn copy file:///tmp/repos/test/trunk file:///tmp/repos/test/tags/0.6.32-prerelease -m "tag tree" Committed revision 12. 不要担心忘记作标签—你可以在以后任何时候给一个旧版本作标签： $ svn copy -r 11 file:///tmp/repos/test/trunk file:///tmp/repos/test/tags/0.6.32-prerelease -m "Forgot to tag at rev 11" Committed revision 13. svn delete 从工作拷贝或版本库删除一个项目。 svn delete PATH... svn delete URL... PATH指定的项目会在下次提交删除，文件（和没有提交的目录）会立即从版本库删除，这个命令不会删除任何未版本化或已经修改的项目；使用--force选项可以覆盖这种行为方式。 URL指定的项目会在直接提交中从版本库删除，多个URL的提交是原子操作。 del, remove, rm 如果操作对象是文件则是工作拷贝变化，对象是URL则会影响版本库。 对URL操作时访问 --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从工作拷贝删除文件只是预定要删除，当你提交，文件才会从版本库删除。 $ svn delete myfile D myfile $ svn commit -m "Deleted file 'myfile'." Deleting myfile Transmitting file data . Committed revision 14. 然而直接删除一个URL，你需要提供一个日志信息： $ svn delete -m "Deleting file 'yourfile'" file:///tmp/repos/test/yourfile Committed revision 15. 如下是强制删除本地已修改文件的例子： $ svn delete over-there svn: Attempting restricted operation for modified resource svn: Use --force to override this restriction svn: 'over-there' has local modifications $ svn delete --force over-there D over-there svn diff 比较两条路径的区别。 diff [-r N[:M]] [TARGET[@REV]...] diff [-r N[:M]] --old OLD-TGT[@OLDREV] [--new NEW-TGT[@NEWREV]] [PATH...] diff OLD-URL[@OLDREV] NEW-URL[@NEWREV] 显示两条路径的区别，svn diff有三种使用方式： svn diff [-r N[:M]] [--old OLD-TGT] [--new NEW-TGT] [PATH...]会显示OLD-TGT和NEW-TGT的区别。如果给定路径PATH，它会被看作OLD-TGT和NEW-TGT的相对路径，输出也会限制在这些路径的区别上。OLD-TGT和NEW-TGT可以是工作拷贝路径或者是URL[@REV]。OLD-TGT缺省是当前工作目录，而NEW-TGT缺省是OLD-TGT。N缺省是BASE，M缺省时当前目录的版本，但如果NEW-TGT是一个URL，则默认是HEAD。svn diff -r N设置OLD-TGT的修订版本为N，svn diff -r N:M设置NEW-TGT的修订版本是M。 svn diff [-r N[:M]] URL1[@N] URL2[@M]是svn diff [-r N[:M]] --old=URL1 --new=URL2的缩写。 TARGET是一个URL，然后可以使用前面提到的--revision或@符号来指定N和M。 如果TARGET是工作拷贝路径，则--revision选项的含义是： --revision N:M 服务器比较 TARGET@N和TARGET@M。 --revision N 客户端比较TARGET@N和工作拷贝。 （无--revision） 客户端比较base和 TARGET的TARGET。 如果使用其他语法，服务器会比较URL1和URL2各自的N和M。如果省掉N或M，会假定为HEAD。 缺省情况下，svn diff忽略文件的祖先，只会比较两个文件的内容。如果你使用--notice-ancestry，比较修订版本（也就是，当你运行svn diff比较两个内容相同，但祖先历史不同的对象会看到所有的内容被删除又再次添加）时就会考虑路径的祖先。 di 无 获得工作拷贝非BASE修订版本的区别时会 --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 比较BASE和你的工作拷贝（svn diff最经常的用法）： $ svn diff COMMITTERS Index: COMMITTERS =================================================================== --- COMMITTERS (revision 4404) +++ COMMITTERS (working copy) 察看你的工作拷贝对旧的修订版本的修改： $ svn diff -r 3900 COMMITTERS Index: COMMITTERS =================================================================== --- COMMITTERS (revision 3900) +++ COMMITTERS (working copy) 使用@语法与修订版本3000和35000比较： $ svn diff http://svn.collab.net/repos/svn/trunk/COMMITTERS@3000 \ http://svn.collab.net/repos/svn/trunk/COMMITTERS@3500 Index: COMMITTERS =================================================================== --- COMMITTERS (revision 3000) +++ COMMITTERS (revision 3500) … 使用范围符号来比较修订版本3000和3500（在这种情况下只能传递一个URL）： $ svn diff -r 3000:3500 http://svn.collab.net/repos/svn/trunk/COMMITTERS Index: COMMITTERS =================================================================== --- COMMITTERS (revision 3000) +++ COMMITTERS (revision 3500) 使用范围符号比较修订版本3000和3500trunk中的所有文件： $ svn diff -r 3000:3500 http://svn.collab.net/repos/svn/trunk 使用范围符号比较修订版本3000和3500trunk中的三个文件： $ svn diff -r 3000:3500 --old http://svn.collab.net/repos/svn/trunk COMMITTERS README HACKING 如果你有工作拷贝，你不必输入这么长的URL： $ svn diff -r 3000:3500 COMMITTERS Index: COMMITTERS =================================================================== --- COMMITTERS (revision 3000) +++ COMMITTERS (revision 3500) 使用--diff-cmd CMD -x来指定外部区别程序 $ svn diff --diff-cmd /usr/bin/diff -x "-i -b" COMMITTERS Index: COMMITTERS =================================================================== 0a1,2 > This is a test > svn export 导出一个干净的目录树。 svn export [-r REV] URL[@PEGREV] [PATH] svn export [-r REV] PATH1[@PEGREV] [PATH2] 第一种从版本库导出干净工作目录树的形式是指定URL，如果指定了修订版本REV，会导出相应的版本，如果没有指定修订版本，则会导出HEAD，导出到PATH。如果省略PATH，URL的最后一部分会作为本地目录的名字。 从工作拷贝导出干净目录树的第二种形式是指定PATH1到PATH2，所有的本地修改将会保留，但是不再版本控制下的文件不会拷贝。 无 本地磁盘 只有当从URL导出时会访问 --revision (-r) REV --quiet (-q) --force --username USER --password PASS --no-auth-cache --non-interactive --non-recursive --config-dir DIR --native-eol EOL --ignore-externals 从你的工作拷贝导出（不会打印每一个文件和目录）： $ svn export a-wc my-export Export complete. 从版本库导出目录（打印所有的文件和目录）： $ svn export file:///tmp/repos my-export A my-export/test A my-export/quiz … Exported revision 15. 当使用操作系统特定的分发版本，使用特定的EOL字符作为行结束符号导出一棵树会非常有用。--native-eol选项会这样做，但是如果影响的文件拥有svn:eol-style = native属性，举个例子，导出一棵使用CRLF作为行结束的树（可能是为了做一个Windows的.zip文件分发版本）： $ svn export file://tmp/repos my-export --native-eol CRLF A my-export/test A my-export/quiz … Exported revision 15. svn help 帮助！ svn help [SUBCOMMAND...] 当手边没有这本书时，这是你使用Subversion最好的朋友！ ?, h 无 不访问 --version --quiet (-q) svn import 递归提交一个路径的拷贝到版本库。 svn import [PATH] URL 递归提交一个路径的拷贝到URL。如果省略PATH，默认是.。版本库中对应的父目录必须已经创建。 无 版本库 是 --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 --ignore-externals 这会导入本地目录myproj到版本库的 根目录： $ svn import -m "New import" myproj http://svn.red-bean.com/repos/test Adding myproj/sample.txt … Transmitting file data ......... Committed revision 16. 这将本地目录myproj导入到版本库的trunk/misc，trunk/misc在导入之前不需要存在—svn import会递归的为你创建目录： $ svn import -m "New import" myproj \ http://svn.red-bean.com/repos/test/trunk/misc/myproj Adding myproj/sample.txt … Transmitting file data ......... Committed revision 19. 在导入数据之后，你会发现原先的目录树并没有纳入版本控制，为了开始工作，你还是要运行svn checkout得到一个干净的目录树工作拷贝。 svn info 显示本地或远程条目的信息。 svn info [TARGET...] 打印你的工作拷贝路径和URL的信息，包括： 路经 名称 URL 修订版本 版本库的根 版本库的UUID 节点类型 最后修改的作者 最后修改的修订版本 最后修改的日期 最后更新的文本 最后更新的属性 核对 锁定令牌 锁定拥有者 锁定创建时间 无 无 对URL操作时访问 --targets FILENAME --recursive (-R) --revision (-r) --config-dir DIR svn info会展示所有项目的所有有用信息，它会显示文件的信息： $ svn info foo.c Path: foo.c Name: foo.c URL: http://svn.red-bean.com/repos/test/foo.c Repository Root: http://svn.red-bean.com/repos/test Repository UUID: 5e7d134a-54fb-0310-bd04-b611643e5c25 Revision: 4417 Node Kind: file Schedule: normal Last Changed Author: sally Last Changed Rev: 20 Last Changed Date: 2003-01-13 16:43:13 -0600 (Mon, 13 Jan 2003) Text Last Updated: 2003-01-16 21:18:16 -0600 (Thu, 16 Jan 2003) Properties Last Updated: 2003-01-13 21:50:19 -0600 (Mon, 13 Jan 2003) Checksum: /3L38YwzhT93BWvgpdF6Zw== 它也会展示目录的信息： $ svn info vendors Path: vendors URL: http://svn.red-bean.com/repos/test/vendors Repository Root: http://svn.red-bean.com/repos/test Repository UUID: 5e7d134a-54fb-0310-bd04-b611643e5c25 Revision: 19 Node Kind: directory Schedule: normal Last Changed Author: harry Last Changed Rev: 19 Last Changed Date: 2003-01-16 23:21:19 -0600 (Thu, 16 Jan 2003) svn info也可以针对URL操作（另外，可以注意一下例子中的readme.doc文件已经被锁定，所以也会显示锁定信息）： $ svn info http://svn.red-bean.com/repos/test/readme.doc Path: readme.doc Name: readme.doc URL: http://svn.red-bean.com/repos/test/readme.doc Repository Root: http://svn.red-bean.com/repos/test Repository UUID: 5e7d134a-54fb-0310-bd04-b611643e5c25 Revision: 1 Node Kind: file Schedule: normal Last Changed Author: sally Last Changed Rev: 42 Last Changed Date: 2003-01-14 23:21:19 -0600 (Tue, 14 Jan 2003) Text Last Updated: 2003-01-14 23:21:19 -0600 (Tue, 14 Jan 2003) Checksum: d41d8cd98f00b204e9800998ecf8427e Lock Token: opaquelocktoken:14011d4b-54fb-0310-8541-dbd16bd471b2 Lock Owner: harry Lock Created: 2003-01-15 17:35:12 -0600 (Wed, 15 Jan 2003) svn list 列出版本库目录的条目。 svn list [TARGET[@REV]...] 列出每一个TARGET文件和TARGET目录的内容，如果TARGET是工作拷贝路径，会使用对应的版本库URL。 缺省的TARGET是.，意味着当前工作拷贝的版本库URL。 伴随--verbose，如下的字段展示了项目的状态： 最后一次提交的修订版本号 最后一次提交的作者 大小（单位字节） 最后提交的日期时间 使用选项--xml，输出是XML格式（如果没有指定--incremental，会包括一个头和一个围绕的元素）。会展示所有的信息；不接受--verbose选项。 ls 无 是 --revision (-r) REV --verbose (-v) --recursive (-R) --incremental --xml --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR 如果你希望在没有下载工作拷贝时察看版本库有哪些文件，svn list会非常有用： $ svn list http://svn.red-bean.com/repos/test/support README.txt INSTALL examples/ … 你也可以传递--verbose选项来得到额外信息，非常类似UNIX的ls -l命令： $ svn list --verbose file:///tmp/repos 16 sally 28361 Jan 16 23:18 README.txt 27 sally 0 Jan 18 15:27 INSTALL 24 harry Jan 18 11:27 examples/ 更多细节见。 svn lock 锁定版本库的工作拷贝路径或URL，所以没有其他用户可以提交这些文件的修改。 svn lock TARGET... 锁定每个TARGET。如果任何TARGET已经被另一个用户锁定，则会打印警告信息并且继续锁定剩下的TARGET。可以使用--force从其它用户来窃取锁定。 无 工作拷贝，版本库 是 --targets ARG --message (-m) ARG --file (-F) ARG --force-log --encoding ARG --username ARG --password ARG --no-auth-cache --non-interactive --config-dir ARG --force 在工作拷贝锁定两个文件： $ svn lock tree.jpg house.jpg 'tree.jpg' locked by user 'harry'. 'house.jpg' locked by user 'harry'. 锁定工作拷贝的一个被其它用户锁定的文件： $ svn lock tree.jpg svn: warning: Path '/tree.jpg is already locked by user 'harry in \ filesystem '/svn/repos/db' $ svn lock --force foo 'tree.jpg' locked by user 'sally'. 没有工作拷贝的情况下锁定文件： $ svn lock http://svn.red-bean.com/repos/test/tree.jpg 'tree.jpg' locked by user 'sally'. 更多细节见。 svn log 显示提交日志信息。 svn log [PATH] svn log URL [PATH...] 缺省目标是你的当前目录的路径，如果没有提供参数，svn log会显示当前目录下的所有文件和目录的日志信息，你可以通过指定路径来精炼结果，一个或多个修订版本，或者是任何两个的组合。对于本地路径的缺省修订版本范围BASE:1。 如果你只是指定一个URL，就会打印这个URL上所有的日志信息，如果添加部分路径，只有这条路径下的URL信息会被打印，URL缺省的修订版本范围是HEAD:1。 svn log使用--verbose选项也会打印所有影响路径的日志信息，使用--quiet选项不会打印日志信息正文本身（这与--verbose协调一致）。 每个日志信息只会打印一次，即使是那些明确请求不止一次的路径，日志会跟随在拷贝过程中，使用--stop-on-copy可以关闭这个特性，可以用来监测分支点。 无 无 是 --revision (-r) REV --quiet (-q) --verbose (-v) --targets FILENAME --stop-on-copy --incremental --limit NUM --xml --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR 你可以在顶级目录运行svn log看到工作拷贝中所有修改的路径的日志信息： $ svn log ------------------------------------------------------------------------ r20 | harry | 2003-01-17 22:56:19 -0600 (Fri, 17 Jan 2003) | 1 line Tweak. ------------------------------------------------------------------------ r17 | sally | 2003-01-16 23:21:19 -0600 (Thu, 16 Jan 2003) | 2 lines … 检验一个特定文件所有的日志信息： $ svn log foo.c ------------------------------------------------------------------------ r32 | sally | 2003-01-13 00:43:13 -0600 (Mon, 13 Jan 2003) | 1 line Added defines. ------------------------------------------------------------------------ r28 | sally | 2003-01-07 21:48:33 -0600 (Tue, 07 Jan 2003) | 3 lines … 如果你手边没有工作拷贝，你可以查看一个URL的日志： $ svn log http://svn.red-bean.com/repos/test/foo.c ------------------------------------------------------------------------ r32 | sally | 2003-01-13 00:43:13 -0600 (Mon, 13 Jan 2003) | 1 line Added defines. ------------------------------------------------------------------------ r28 | sally | 2003-01-07 21:48:33 -0600 (Tue, 07 Jan 2003) | 3 lines … 如果你希望查看某个URL下面不同的多个路径，你可以使用URL [PATH...]语法。 $ svn log http://svn.red-bean.com/repos/test/ foo.c bar.c ------------------------------------------------------------------------ r32 | sally | 2003-01-13 00:43:13 -0600 (Mon, 13 Jan 2003) | 1 line Added defines. ------------------------------------------------------------------------ r31 | harry | 2003-01-10 12:25:08 -0600 (Fri, 10 Jan 2003) | 1 line Added new file bar.c ------------------------------------------------------------------------ r28 | sally | 2003-01-07 21:48:33 -0600 (Tue, 07 Jan 2003) | 3 lines … 当你想¿ž接多个队日志命令的调用结果，你会希望使用--incremental选项。svn log通常会在日志信息的开头和每一小段间打印一行虚线，如果你对一段修订版本运行svn log，你会得到下面的结果： $ svn log -r 14:15 ------------------------------------------------------------------------ r14 | ... ------------------------------------------------------------------------ r15 | ... ------------------------------------------------------------------------ 然而，如果你希望收集两个不连续的日志信息到一个文件，你会这样做： $ svn log -r 14 > mylog $ svn log -r 19 >> mylog $ svn log -r 27 >> mylog $ cat mylog ------------------------------------------------------------------------ r14 | ... ------------------------------------------------------------------------ ------------------------------------------------------------------------ r19 | ... ------------------------------------------------------------------------ ------------------------------------------------------------------------ r27 | ... ------------------------------------------------------------------------ 你可以使用incremental选项来避免两行虚线带来的混乱： $ svn log --incremental -r 14 > mylog $ svn log --incremental -r 19 >> mylog $ svn log --incremental -r 27 >> mylog $ cat mylog ------------------------------------------------------------------------ r14 | ... ------------------------------------------------------------------------ r19 | ... ------------------------------------------------------------------------ r27 | ... --incremental选项为--xml提供了一个相似的输出控制。 如果你在特定路径和修订版本运行svn log，输出结果为空 $ svn log -r 20 http://svn.red-bean.com/untouched.txt ------------------------------------------------------------------------ 这只意味着这条路径在那个修订版本没有修改，如果从版本库的顶级目录运行这个命令，或者是你知道那个修订版本修改了那个文件，你可以明确的指定它： $ svn log -r 20 touched.txt ------------------------------------------------------------------------ r20 | sally | 2003-01-17 22:56:19 -0600 (Fri, 17 Jan 2003) | 1 line Made a change. ------------------------------------------------------------------------ svn merge 应用两组源文件的差别到工作拷贝路径。 svn merge sourceURL1[@N] sourceURL2[@M] [WCPATH] svn merge sourceWCPATH1@N sourceWCPATH2@M [WCPATH] svn merge -r N:M SOURCE[@REV] [WCPATH] 第一种和第二种形式里，源路径（第一种是URL，第二种是工作拷贝路径）用修订版本号N和M指定，这是要比较的两组源文件，如果省略修订版本号，缺省是HEAD。 第三种形式，SOURCE可以是URL或者工作拷贝项目，与之对应的URL会被使用。在修订版本号N和M的URL定义了要比较的两组源。 WCPATH是接收变化的工作拷贝路径，如果省略WCPATH，会假定缺省值.，除非源有相同基本名称与.中的某一文件名字匹配：在这种情况下，区别会应用到那个文件。 不像svn diff，合并操作在执行时会考虑文件的祖先，当你从一个分支合并到另一个分支，而这两个分支有各自重命名的文件时，这一点会非常重要。 无 工作拷贝 只有在对URL操作时会 --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 将一个分支合并回主干（假定你有一份主干的工作拷贝，分支在修订版本250创建）： $ svn merge -r 250:HEAD http://svn.red-bean.com/repos/branches/my-branch U myproj/tiny.txt U myproj/thhgttg.txt U myproj/win.txt U myproj/flo.txt 如果你的分支在修订版本23，你希望将主干的修改合并到分支，你可以在你的工作拷贝的分支上这样做： $ svn merge -r 23:30 file:///tmp/repos/trunk/vendors U myproj/thhgttg.txt … 合并一个单独文件的修改： $ cd myproj $ svn merge -r 30:31 thhgttg.txt U thhgttg.txt svn mkdir 创建一个纳入版本控制的新目录。 svn mkdir PATH... svn mkdir URL... 创建一个目录，名字是提供的PATH或者URL的最后一部分，工作拷贝PATH指定的目录会预定要添加，而通过URL指定的目录会作为一次立即提交在版本库建立。多个目录URL的提交是原子操作，在两种情况下，中介目录必须已经存在。 无 如果是对URL操作则会影响版本库，否则是工作拷贝 只有在对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 mkdir newdir A newdir 在版本库创建一个目录（立即提交，所以需要日志信息）： $ svn mkdir -m "Making a new dir." http://svn.red-bean.com/repos/newdir Committed revision 26. svn move 移动一个文件或目录。 svn move SRC DST 这个命令移动文件或目录到你的工作拷贝或者是版本库。 这个命令同svn copy加一个svn delete等同。 Subversion不支持在工作拷贝和URL之间拷贝，此外，你只可以一个版本库内移动文件—Subversion不支持跨版本库的移动。 WC -> WC 移动和预订一个文件或目录将要添加（包含历史）。 URL -> URL 完全服务器端的重命名。 mv, rename, ren 如果对URL操作会影响版本库，否则只影响工作拷贝 只有在对URL操作时会 --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 移动工作拷bede一个文件： $ svn move foo.c bar.c A bar.c D foo.c 移动版本库中的一个文件（一个立即提交，所以需要提交信息）： $ svn move -m "Move a file" http://svn.red-bean.com/repos/foo.c \ http://svn.red-bean.com/repos/bar.c Committed revision 27. svn propdel 删除一个项目的一个属性。 svn propdel PROPNAME [PATH...] svn propdel PROPNAME --revprop -r REV [URL] 这会删除文件、目录或修订版本的属性。第一种形式是在工作拷贝删除版本化属性，第二种是在一个版本库修订版本中删除未版本化的属性。 pdel, pd 如果对URL操作会影响版本库，否则只影响工作拷贝 只有在对URL操作时会 --quiet (-q) --recursive (-R) --revision (-r) REV --revprop --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR 删除你的工作拷贝中一个文件的一个属性 $ svn propdel svn:mime-type some-script property 'svn:mime-type' deleted from 'some-script'. 删除一个修订版本的属性： $ svn propdel --revprop -r 26 release-date property 'release-date' deleted from repository revision '26' svn propedit 修改一个或多个版本控制之下文件的属性。 svn propedit PROPNAME PATH... svn propedit PROPNAME --revprop -r REV [URL] 使用喜欢的编辑器编辑一个或多个属性，第一种形式是在工作拷贝编辑版本化的属性，第二种形式是远程编辑未版本化的版本库修订版本属性。 pedit, pe 如果对URL操作会影响版本库，否则只影响工作拷贝 只有在对URL操作时会 --revision (-r) REV --revprop --username USER --password PASS --no-auth-cache --non-interactive --encoding ENC --editor-cmd EDITOR --config-dir DIR svn propedit对修改多个值的属性非常简单： $ svn propedit svn:keywords foo.c <svn will launch your favorite editor here, with a buffer open containing the current contents of the svn:keywords property. You can add multiple values to a property easily here by entering one value per line.> Set new value for property 'svn:keywords' on 'foo.c' svn propget 打印一个属性的值。 svn propget PROPNAME [TARGET[@REV]...] svn propget PROPNAME --revprop -r REV [URL] 打印一个文件、目录或修订版本的一个属性的值，第一种形式是打印工作拷贝中一个或多个项目的版本化的属性，第二种形式是远程打印版本库修订版本的未版本化的属性。属性的详情见。 pget, pg 如果对URL操作会影响版本库，否则只影响工作拷贝 只有在对URL操作时会 --recursive (-R) --revision (-r) REV --revprop --strict --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR 检查工作拷贝的一个文件的一个属性： $ svn propget svn:keywords foo.c Author Date Rev 对于修订版本属性相同： $ svn propget svn:log --revprop -r 20 Began journal. svn proplist 列出所有的属性。 svn proplist [TARGET[@REV]...] svn proplist --revprop -r REV [URL] 列出文件、目录或修订版本的属性，第一种形式是列出工作拷贝的所有版本化的属性，第二种形式是列出版本库修订版本的未版本化的属性。 plist, pl 如果对URL操作会影响版本库，否则只影响工作拷贝 只有在对URL操作时会 --verbose (-v) --recursive (-R) --revision (-r) REV --quiet (-q) --revprop --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR 你可以使用proplist察看你的工作拷贝的一个项目的属性： $ svn proplist foo.c Properties on 'foo.c': svn:mime-type svn:keywords owner 通过--verbose选项，svn proplist也可以非常便利的显示属性的值： $ svn proplist --verbose foo.c Properties on 'foo.c': svn:mime-type : text/plain svn:keywords : Author Date Rev owner : sally svn propset 设置文件、目录或者修订版本的属性PROPNAME为PROPVAL。 svn propset PROPNAME [PROPVAL | -F VALFILE] PATH... svn propset PROPNAME --revprop -r REV [PROPVAL | -F VALFILE] [URL] 设置文件、目录或者修订版本的属性PROPNAME为PROPVAL。第一个例子在工作拷贝创建了一个版本化的本地属性修改，第二个例子创建了一个未版本化的远程的对版本库修订版本的属性修改。 Subversion有一系列特殊的影响行为方式的属性，关于这些属性的详情请见。 pset, ps 如果对URL操作会影响版本库，否则只影响工作拷贝 只有在对URL操作时会 --file (-F) FILE --quiet (-q) --revision (-r) REV --targets FILENAME --recursive (-R) --revprop --username USER --password PASS --no-auth-cache --non-interactive --encoding ENC --force --config-dir DIR 设置文件的mimetype： $ svn propset svn:mime-type image/jpeg foo.jpg property 'svn:mime-type' set on 'foo.jpg' 在UNIX系统，如果你希望一个文件设置执行权限： $ svn propset svn:executable ON somescript property 'svn:executable' set on 'somescript' 或许为了合作者的利益你有一个内部的属性设置： $ svn propset owner sally foo.c property 'owner' set on 'foo.c' 如果你在特定修订版本的日志信息里有一些错误，并且希望修改，可以使用--revprop设置svn:log为新的日志信息： $ svn propset --revprop -r 25 svn:log "Journaled about trip to New York." property 'svn:log' set on repository revision '25' 或者，你没有工作拷贝，你可以提供一个URL。 $ svn propset --revprop -r 26 svn:log "Document nap." http://svn.red-bean.com/repos property 'svn:log' set on repository revision '25' 最后，你可以告诉propset从一个文件得到输入，你甚至可以使用这个方式来设置一个属性为二进制内容： $ svn propset owner-pic -F sally.jpg moo.c property 'owner-pic' set on 'moo.c' 缺省，你不可以在Subversion版本库修改修订版本属性，你的版本库管理员必须显示的通过创建一个名字为pre-revprop-change的钩子来允许修订版本属性修改，关于钩子脚本的详情请见。 svn resolved 删除工作拷贝文件或目录的冲突状态。 svn resolved PATH... 删除工作拷贝文件或目录的conflicted状态。这个程序不是语义上的改变冲突标志，它只是删除冲突相关的人造文件，从而重新允许PATH提交；也就是说，它告诉Subversion冲突已经解决了。关于解决冲突更深入的考虑可以查看。 无 工作拷贝 否 --targets FILENAME --recursive (-R) --quiet (-q) --config-dir DIR 如果你在更新时得到冲突，你的工作拷贝会产生三个新的文件： $ svn update C foo.c Updated to revision 31. $ ls foo.c foo.c.mine foo.c.r30 foo.c.r31 当你解决了foo.c的冲突，并且准备提交，运行svn resolved让你的工作拷贝知道你已经完成了所有事情。 你可以仅仅删除冲突的文件并且提交，但是svn resolved除了删除冲突文件，还修正了一些记录在工作拷贝管理区域的记录数据，所以我们推荐你使用这个命令。 svn revert 取消所有的本地编辑。 svn revert PATH... 恢复所有对文件和目录的修改，并且解决所有的冲突状态。svn revert不会只是恢复工作拷贝中一个项目的内容，也包括了对属性修改的恢复。最终，你可以使用它来取消所有已经做过的预定操作（例如，文件预定要添加或删除可以恢复）。 无 工作拷贝 否 --targets FILENAME --recursive (-R) --quiet (-q) --config-dir DIR 丢弃对一个文件的修改： $ svn revert foo.c Reverted foo.c 如果你希望恢复一整个目录的文件，可以使用--recursive选项： $ svn revert --recursive . Reverted newdir/afile Reverted foo.c Reverted bar.txt 最后，你可以取消预定的操作： $ svn add mistake.txt whoops A mistake.txt A whoops A whoops/oopsie.c $ svn revert mistake.txt whoops Reverted mistake.txt Reverted whoops $ svn status ? mistake.txt ? whoops 如果你没有给svn revert提供了目标，它不会做任何事情—为了保护你不小心失去对工作拷贝的修改，svn revert需要你提供至少一个目标。 svn status 打印工作拷贝文件和目录的状态。 svn status [PATH...] 打印工作拷贝文件和目录的状态。如果没有参数，只会打印本地修改的项目（不会访问版本库），使用--show-updates选项，会添加工作修订版本和服务器过期信息。使用--verbose会打印每个项目的完全修订版本信息。 输出的前六列都是一个字符宽，每一列给出了工作拷贝项目的每一方面的信息。 第一列指出一个项目的是添加、删除还是其它的修改。 ' ' 没有修改。 'A' 预定要添加的项目。 'D' 预定要删除的项目。 'M' 项目已经修改了。 'R' 项目在工作拷贝中已经被替换了。这意味着文件预定要删除，然后有一个同样名称的文件要在同一个位置替换它。 'C' 项目的内容（相对于属性）与更新得到的数据冲突了。 'X' 项目与外部定义相关。 'I' 项目被忽略（例如使用svn:ignore属性）。 '?' 项目不在版本控制之下。 '!' 项目已经丢失（例如，你使用svn移动或者删除了它）。这也说明了一个目录不是完整的（一个检出或更新中断）。 '~' 项目作为一种对象（文件、目录或链接）纳入版本控制，但是已经被另一种对象替代。 第二列告诉一个文件或目录的属性的状态。 ' ' 没有修改。 'M' 这个项目的属性已经修改。 'C' 这个项目的属性与从版本库得到的更新有冲突。 第三列只在工作拷贝锁定时才会出现。（见。） ' ' 项目没有锁定。 'L' 项目已经锁定。 第四列只在预定包含历史添加的项目出现。 ' ' 没有历史预定要提交。 '+' 历史预定要伴随提交。 第五列只在项目跳转到相对于它的父目录时出现（见）。 ' ' 项目是它的父目录的孩子。 'S' 项目已经转换。 第六列显示锁定信息。 ' ' 当使用--show-updates，文件没有锁定。如果不使用--show-updates，这意味着文件在工作拷贝被锁定。 K 文件锁定在工作拷贝。 O 文件被另一个工作拷贝的另一个用户锁定，只有在使用--show-updates时显示。 T 文件锁定在工作拷贝，但是锁定被窃取而不可用。文件当前锁定在版本库，只有在使用--show-updates时显示。 B 文件锁定在工作拷贝，但是锁定被破坏而不可用。文件当前锁定在版本库，只有在使用--show-updates时显示。 过期信息出现在第七列（只在使用--show-updates选项时出现）。 ' ' 这个项目在工作拷贝是最新的。 '*' 在服务器这个项目有了新的修订版本。 余下的字段是可变得宽度且使用空格分隔，如果使用--show-updates或--verbose选项，工作修订版本是下一个字段。 如果传递--verbose选项，最后提交的修订版本和最后的提交作者会在后面显示。 工作拷贝路径永远是最后一个字段，所以它可以包括空格。 stat, st 无 只有使用--show-updates时会访问 --show-updates (-u) --verbose (-v) --non-recursive (-N) --quiet (-q) --no-ignore --username USER --password PASS --no-auth-cache --non-interactive --config-dir --ignore-externals 这是查看你在工作拷贝所做的修改的最简单的方法。 $ svn status wc M wc/bar.c A + wc/qax.c 如果你希望找出工作拷贝哪些文件是最新的，使用--show-updates选项（这不会对工作拷贝有任何修改）。这里你会看到wc/foo.c在上次更新后有了修改： $ svn status --show-updates wc M 965 wc/bar.c * 965 wc/foo.c A + 965 wc/qax.c Status against revision: 981 --show-updates 只会在过期的项目（如果你运行svn update，就会更新的项目）旁边安置一个星号。--show-updates不会导致状态列表反映项目的版本库版本。 最后，是你能从status子命令得到的所有信息： $ svn status --show-updates --verbose wc M 965 938 sally wc/bar.c * 965 922 harry wc/foo.c A + 965 687 harry wc/qax.c 965 687 harry wc/zig.c Head revision: 981 关于svn status的更多例子可以见。 svn switch 把工作拷贝更新到别的URL。 svn switch URL [PATH] switch --relocate FROM TO [PATH...] 这个子命令更新你的工作拷贝来反映新的URL—通常是一个与你的工作拷贝分享共同祖先的URL，尽管这不是必需的。这是Subversion移动工作拷贝到分支的方式。更深入的了解请见。 sw 工作拷贝 是 --revision (-r) REV --non-recursive (-N) --quiet (-q) --diff3-cmd CMD --relocate --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR 如果你目前所在目录vendors分支到vendors-with-fix，你希望转移到那个分支： $ svn switch http://svn.red-bean.com/repos/branches/vendors-with-fix . U myproj/foo.txt U myproj/bar.txt U myproj/baz.c U myproj/qux.c Updated to revision 31. 为了跳转回来，只需要提供最初取出工作拷贝的版本库URL： $ svn switch http://svn.red-bean.com/repos/trunk/vendors . U myproj/foo.txt U myproj/bar.txt U myproj/baz.c U myproj/qux.c Updated to revision 31. 如果你不希望跳转所有的工作拷贝，你可以只跳转一部分。 有时候管理员会修改版本库的基本位置—换句话说，版本库的内容并不改变，但是访问根的主URL变了。举个例子，主机名变了、URL模式变了或者是URL中的任何一部分改变了。我们不选择重新检出一个工作拷贝，你可以使用svn switch来重写版本库所有URL的开头。使用--relocate来做这种替换，没有文件内容会改变，访问的版本库也不会改变。只是像在工作拷贝.svn/运行了一段Perl脚本s/OldRoot/NewRoot/。 $ svn checkout file:///tmp/repos test A test/a A test/b … $ mv repos newlocation $ cd test/ $ svn update svn: Unable to open an ra_local session to URL svn: Unable to open repository 'file:///tmp/repos' $ svn switch --relocate file:///tmp/repos file:///tmp/newlocation . $ svn update At revision 3. 小心使用--relocate选项，如果你输入了错误的选项，你会在工作拷贝创建无意义的URL，会导致整个工作区不可用并且难于修复。理解何时应该使用--relocate也是非常重要的，下面是一些规则： 如果工作拷贝需要反映一个版本库的新目录，只需要使用svn switch。 如果你的工作拷贝还是反映相同的版本库目录，但是版本库本身的位置改变了，使用svn switch --relocate。 svn unlock 解锁工作拷贝路径或URL。 svn unlock TARGET... 解锁每个TARGET。如果任何另一个用户锁定了TARGET，或者没有正确工作拷贝的锁定令牌，打印警告并继续解锁余下的TARGET。使用--force可以打破其它用户或工作拷贝的锁定。 无 工作拷贝，版本库 是 --targets ARG --username ARG --password ARG --no-auth-cache --non-interactive --config-dir ARG --force 解锁工作拷贝中的两个文件： $ svn unlock tree.jpg house.jpg 'tree.jpg' unlocked. 'house.jpg' unlocked. 解锁工作拷贝的一个被其他用户锁定的文件： $ svn unlock tree.jpg svn: 'tree.jpg' is not locked in this working copy $ svn unlock --force tree.jpg 'tree.jpg' unlocked. 没有工作拷贝时解锁一个文件： $ svn unlock http://svn.red-bean.com/repos/test/tree.jpg 'tree.jpg unlocked. 更多细节见. svn update 更新你的工作拷贝。 svn update [PATH...] svn update会把版本库的修改带到工作拷贝，如果没有给定修订版本，它会把你的工作拷贝更新到HEAD修订版本，否则，它会把工作拷贝更新到你用--revision指定的修订版本。为了保持同步，也会删除所有在工作拷贝发现的无效锁定（见）。 对于每一个更新的项目开头都有一个表示所做动作的字符，这些字符有下面的意思： A 添加 D 删除 U 更新 C 冲突 G 合并 第一列的字符反映文件本身的更新，而第二列会反映文件属性的更新。 up 工作拷贝 是 --revision (-r) REV --non-recursive (-N) --quiet (-q) --diff3-cmd CMD --username USER --password PASS --no-auth-cache --non-interactive --config-dir DIR --ignore-externals 获取你上次更新之后版本库的修改： $ svn update A newdir/toggle.c A newdir/disclose.c A newdir/launch.c D newdir/README Updated to revision 32. 你也可以将工作拷贝更新到旧的修订版本（Subversion没有CVS的sticky文件的概念；见）： $ svn update -r30 A newdir/README D newdir/toggle.c D newdir/disclose.c D newdir/launch.c U foo.c Updated to revision 30. 如果你希望检查单个文件的旧的修订版本，你会希望使用svn cat。 svnadmin是一个用来监控和修改Subversion版本库的管理工具，详情请见。 因为svnadmin直接访问版本库（因此只可以在存放版本库的机器上使用），它通过路径访问版本库，而不是URL。 --bdb-log-keep （Berkeley DB特定）关闭数据库日志自动日志删除功能。 --bdb-txn-nosync （Berkeley DB特定）当提交数据库事务时关闭fsync。 --bypass-hooks 绕过版本库钩子系统。 --clean-logs 删除不使用的Berkeley DB日志。 --force-uuid 缺省情况下，当版本库加载已经包含修订版本的数据时svnadmin会忽略流中的UUID，这个选项会导致版本库的UUID设置为流的UUID。 --ignore-uuid 缺省情况下，当加载空版本库时，svnadmin会使用来自流中的UUID，这个选项会导致忽略UUID。 --incremental 导出一个修订版本针对前一个修订版本的区别，而不是通常的完全结果。 --parent-dir DIR 当加载一个转储文件时，根路径为DIR而不是/。 --revision (-r) ARG 指定一个操作的修订版本。 --quiet 不显示通常的过程—只显示错误。 --use-post-commit-hook 当导入使用一个转储文件时，在每次新的修订版本产生时运行版本库post-commit钩子。 --use-pre-commit-hook 当加载一个转储文件时，每次新加修订版本之前运行版本库的pre-commit钩子。如果钩子失败，终止提交并中断加载进程。 svnadmin create 创建一个新的空的版本库。 svnadmin create REPOS_PATH 在提供的路径上创建一个新的空的版本库，如果提供的目录不存在，它会为你创建。记住svnadmin只工作在本地路径，而不是URL。 对于Subversion 1.2，svnadmin缺省使用fsfs文件系统后端创建版本库。 --bdb-txn-nosync --bdb-log-keep --config-dir DIR --fs-type TYPE 创建一个版本库就是这样简单： $ svnadmin create /usr/local/svn/repos 在Subversion 1.0，一定会创建一个Berkeley DB版本库，在Subversion 1.1，Berkeley DB版本库是缺省类型，但是一个FSFS版本库也是可以创建，使用--fs-type选项： $ svnadmin create /usr/local/svn/repos --fs-type fsfs svnadmin deltify 修订版本范围的路径的增量变化。 svnadmin deltify [-r LOWER[:UPPER]] REPOS_PATH svnadmin deltify因为历史原因之存在于1.0.x，这个命令已经废弃，不再需要。 它开始于当Subversion提供了管理员控制版本库压缩策略的能力，结果是复杂工作得到了非常小的收益，所以这个特性被废弃了。 --revision (-r) --quiet svnadmin dump 将文件系统的内容转储到标准输出。 svnadmin dump REPOS_PATH [-r LOWER[:UPPER]] [--incremental] 使用dumpfile可移植格式将文件系统的内容转储到标准输出，将反馈发送到标准错误，导出的修订版本从LOWER到UPPER。如果没有提供修订版本，会导出所有的修订版本树，如果只提供LOWER，导出一个修订版本树，通常的用法见。 缺省情况下，Subversion的转储流包含了一个包括所有文件和目录的单独修订版本（请求的修订版本范围的第一个），后面是其它的只包含本修订所修改的文件和目录的修订版本（请求范围的其它版本）。对于修改的文件，转储文件包括所有的内容和属性，对于目录，包括所有的属性。 有一对有用的选项可以改变转储文件产生的方式，第一个是--incremental，使得第一个修订版本只显示其修改的文件和目录，而不是整个目录树，就像转储文件中其它的修订版本。这对产生一个准备导入到已经有数据的版本库时非常有用。 第二个有用的选项是--deltas，这个选项导致svnadmin dump不会保留修改文件的所有内容，而只是记录修改的部分。这样减少（有些情况下是非常大的）了svnadmin dump产生的转储文件的大小。然而，也有缺点—增量转储文件需要更多的CPU来创建，也不可以用svndumpfilter操作，也不如非增量文件容易被如gzip和bzip2等第三方工具压缩。 --revision (-r) --incremental --quiet --deltas 转储整个版本库： $ svnadmin dump /usr/local/svn/repos SVN-fs-dump-format-version: 1 Revision-number: 0 * Dumped revision 0. Prop-content-length: 56 Content-length: 56 … 从版本库增量转储一个单独的事务： $ svnadmin dump /usr/local/svn/repos -r 21 --incremental * Dumped revision 21. SVN-fs-dump-format-version: 1 Revision-number: 21 Prop-content-length: 101 Content-length: 101 … svnadmin help svnadmin help [SUBCOMMAND...] 当你困于一个没有网络连接和本书的沙漠岛屿时，这个子命令非常有用。 ?, h svnadmin hotcopy 制作一个版本库的热备份。 svnadmin hotcopy REPOS_PATH NEW_REPOS_PATH 这个子命令会制作一个版本库的完全热拷贝，包括所有的钩子，配置文件，当然还有数据库文件。如果你传递--clean-logs选项，svnadmin会执行热拷贝操作，然后删除不用的Berkeley DB日志文件。你可以在任何时候运行这个命令得到一个版本库的安全拷贝，不管其它进程是否使用这个版本库。 --clean-logs svnadmin list-dblogs 询问Berkeley DB在给定的Subversion版本库有哪些日志文件存在（只有在版本库使用bdb作为后端时使用）。 svnadmin list-dblogs REPOS_PATH Berkeley DB创建了记录所有版本库修改的日志，允许我们在面对大灾难时恢复。除非你开启了DB_LOG_AUTOREMOVE，否则日志文件会累积，尽管大多数是不再使用可以从磁盘删除得到空间。详情见。 svnadmin list-unused-dblogs 询问Berkeley DB哪些日志文件可以安全的删除（只有在版本库使用bdb作为后端时使用）。 svnadmin list-unused-dblogs REPOS_PATH Berkeley DB创建了记录所有版本库修改的日志，允许我们在面对大灾难时恢复。除非你开启了DB_LOG_AUTOREMOVE，否则日志文件会累积，尽管大多数是不再使用，可以从磁盘删除得到空间。详情见。 删除所有不用的日志文件： $ svnadmin list-unused-dblogs /path/to/repos /path/to/repos/log.0000000031 /path/to/repos/log.0000000032 /path/to/repos/log.0000000033 $ svnadmin list-unused-dblogs /path/to/repos | xargs rm ## disk space reclaimed! svnadmin load 从标准输出读取转储文件格式流。 svnadmin load REPOS_PATH 从标准输出读取转储文件格式流，提交新的修订版本到版本库文件系统，发送进展反馈到标准输出。 --quiet (-q) --ignore-uuid --force-uuid --use-pre-commit-hook --use-post-commit-hook --parent-dir 这里显示了加载一个备份文件到版本库（当然，使用svnadmin dump）： $ svnadmin load /usr/local/svn/restored < repos-backup <<< Started new txn, based on original revision 1 * adding path : test ... done. * adding path : test/a ... done. … 或者你希望加载到一个子目录： $ svnadmin load --parent-dir new/subdir/for/project /usr/local/svn/restored < repos-backup <<< Started new txn, based on original revision 1 * adding path : test ... done. * adding path : test/a ... done. … svnadmin lslocks 打印所有锁定的描述。