Skip to main content

svn

本文讲述了Linux命令行下常用svn命令的使用方法，希望对您有所帮助。

  • 　　1、Linux命令行下将文件checkout到本地目录

svn checkout path(path是服务器上的目录)

例如：svn checkout svn://192.168.1.1/pro/domain

简写：svn co

  • 　　2、Linux命令行下往版本库中添加新的文件

svn add file

例如：svn add test.php(添加test.php)

svn add *.php(添加当前目录下所有的php文件)

  • 　　3、Linux命令行下将改动的文件提交到版本库

svn commit -m “LogMessage“ [-N] [--no-unlock] PATH(如果选择了保持锁，就使用–no-unlock开关)

例如：svn commit -m “add test file for my test“ test.php

简写：svn ci

  • 　　4、Linux命令行下的加锁/解锁

svn lock -m “LockMessage“ [--force] PATH

例如：svn lock -m “lock test file“ test.php

svn unlock PATH

  • 　　5、Linux命令行下更新到某个版本

svn update -r m path

例如：

svn update如果后面没有目录，默认将当前目录以及子目录下的所有文件都更新到最新版本。

svn update -r 200 test.php(将版本库中的文件test.php还原到版本200)

svn update test.php(更新，于版本库同步。如果在提交的时候提示过期的话，是因为冲突，需要先update，修改文件，然后清除svn resolved，最后再提交commit)

简写：svn up

  • 　　6、Linux命令行下查看文件或者目录状态

1)svn status path(目录下的文件和子目录的状态，正常状态不显示)

【?：不在svn的控制中;M：内容被修改;C：发生冲突;A：预定加入到版本库;K：被锁定】

2)svn status -v path(显示文件和子目录状态)

第一列保持相同，第二列显示工作版本号，第三和第四列显示最后一次修改的版本号和修改人。

注：svn status、svn diff和 svn revert这三条命令在没有网络的情况下也可以执行的，原因是svn在本地的.svn中保留了本地版本的原始拷贝。

简写：svn st

  • 　　7、Linux命令行下删除文件

svn delete path -m “delete test fle“

例如：svn delete svn://192.168.1.1/pro/domain/test.php -m “delete test file”

或者直接svn delete test.php 然后再svn ci -m ‘delete test file‘，推荐使用这种

简写：svn (del, remove, rm)

  • 　　8、Linux命令行下查看日志

svn log path

例如：svn log test.php 显示这个文件的所有修改记录，及其版本号的变化

  • 　　9、Linux命令行下查看文件详细信息

svn info path

例如：svn info test.php

  • 　　10、Linux命令行下比较差异

svn diff path(将修改的文件与基础版本比较)

例如：svn diff test.php

svn diff -r m:n path(对版本m和版本n比较差异)

例如：svn diff -r 200:201 test.php

简写：svn di

  • 　　11、Linux命令行下将两个版本之间的差异合并到当前文件

svn merge -r m:n path

例如：svn merge -r 200:205 test.php(将版本200与205之间的差异合并到当前文件，但是一般都会产生冲突，需要处理一下)

  • 　　12、Linux命令行下SVN 帮助

svn help

svn help ci

以上是常用命令，下面写几个不经常用的

  • 　　13、Linux命令行下版本库下的文件和目录列表

svn list path

显示path目录下的所有属于版本库的文件和目录

简写：svn ls

  • 　　14、Linux命令行下创建纳入版本控制下的新目录

svn mkdir: 创建纳入版本控制下的新目录。

用法: 1、mkdir PATH…

2、mkdir URL…

创建版本控制的目录。

1、每一个以工作副本 PATH 指定的目录，都会创建在本地端，并且加入新增调度，以待下一次的提交。

2、每个以URL指定的目录，都会透过立即提交于仓库中创建.在这两个情况下，所有的中间目录都必须事先存在。

  • 　　15、Linux命令行下恢复本地修改

svn revert: 恢复原始未改变的工作副本文件 (恢复大部份的本地修改)。revert:

用法: revert PATH…

注意: 本子命令不会存取网络，并且会解除冲突的状况。但是它不会恢复被删除的目录

  • 　　16、Linux命令行下代码库URL变更

svn switch (sw): 更新工作副本至不同的URL。

用法: 1、switch URL [PATH]

2、switch –relocate FROM TO [PATH...]

1、更新你的工作副本，映射到一个新的URL，其行为跟“svn update”很像，也会将服务器上文件与本地文件合并。这是将工作副本对应到同一仓库中某个分支或者标记的方法。

2、改写工作副本的URL元数据，以反映单纯的URL上的改变。当仓库的根URL变动(比如方案名或是主机名称变动)，但是工作副本仍旧对映到同一仓库的同一目录时使用这个命令更新工作副本与仓库的对应关系。

  • 　　17、Linux命令行下解决冲突

svn resolved: 移除工作副本的目录或文件的“冲突”状态。

用法: resolved PATH…

注意: 本子命令不会依语法来解决冲突或是移除冲突标记;它只是移除冲突的相关文件，然后让 PATH 可以再次提交。

  • 　　18、Linux命令行下输出指定文件或URL的内容。

svn cat 目标[@版本]…如果指定了版本，将从指定的版本开始查找。

svn cat -r PREV filename > filename (PREV 是上一版本,也可以写具体版本号,这样输出结果是可以提交的)

以上是Linux命令行下常用svn命令的使用方法。

svn ignore 命令行用法​

若想创建了一个文件夹，并且把它加入版本控制，但忽略文件夹中的所有文件的内容：

$ svn mkdir spool

$ svn add spool

$ svn commit -m “Adding ’spool’”

$ svn propset svn:ignore ‘*’ spool

$ svn ci -m ‘Adding “spool” and ignoring its contents.’

若想创建一个文件夹，但不加入版本控制，即忽略这个文件夹：

$ mkdir spool

$ svn propset svn:ignore ’spool’ .

$ svn ci -m ‘Ignoring a directory called “spool”.’

若已经创建了文件夹，并加入了版本控制，现在想忽略这个文件夹，但要保持文件夹的内容：

$ svn export spool spool-tmp

$ svn rm spool

$ svn ci -m ‘Removing inadvertently added directory “spool”.’

$ mv spool-tmp spool

$ svn propset svn:ignore ’spool’ .

$ svn ci -m ‘Ignoring a directory called “spool”.’

若要忽略文件夹里的某几个文件

$ svn mkdir spool

$ svn add spool

$ svn commit -m “Adding ’spool’”

gvim .svnignore

每种要忽略的文件加一行，如：

.svnignore

*.pyc

*.cash

test.php

然后

svn propset svn:ignore -F .svnignore .

svn status

最后一种方法中的最后那个目录很重要。.svnignore里定义的内容只能是当前目录，不能是多层目录，对于要定义多层目录里的文件忽略，可以先写好.svnignore,然后svn propset svn:ignore -F .svnignore ［所要操作的目录］，这样就起作用了

使用命令行 Subversion 访问项目源文件 ● 帮助索引 ● 关于使用软件配置管理 (Subversion) 进行源代码版本控制 ○ 使用命令行 svn 访问项目源文件 ■ Subversion 入门 ■ 处理 SVN 存储库中的文件 ■ 将您的更改提供给 SVN 存储库 ■ 使用存储库 命令行 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 "在此处键入您的信息" 请参见分支和合并。