本文档旨在描述 Apache™ Subversion® 的 1.7.x 系列。如果您运行的是其他版本的 Subversion,强烈建议您访问 https://svnbook.subversion.org.cn/,并查阅适合您 Subversion 版本的文档。

名称

svn copy (cp) — 在工作副本或仓库中复制文件或目录。

语法

svn copy SRC[@REV]... DST

描述

复制工作副本或仓库中的一个或多个文件。 SRCDST 可以是工作副本 (WC) 路径或 URL。复制多个源文件时,将副本添加为 DST(当然,它必须是目录)的直接子项。

WC → WC

复制并安排添加项目(带历史记录)。

WC → URL

立即将 WC 的副本提交到 URL。

URL → WC

将 URL 检出到 WC 并安排添加。

URL → URL

完成服务器端复制。这通常用于分支和标记。

如果没有提供挂钩修订版(即 @REV),默认情况下,将使用 BASE 修订版来复制来自工作副本的文件,而将使用 HEAD 修订版来复制来自 URL 的文件。

[Note] 注意

您只能复制单个仓库中的文件。Subversion 不支持跨仓库复制。

选项

示例

复制工作副本中的项目(这会安排复制 - 直到您提交,才会将任何内容放入仓库)

$ svn copy foo.txt bar.txt
A         bar.txt
$ svn status
A  +    bar.txt

将工作副本中的多个文件复制到子目录

$ svn copy bat.c baz.c qux.c src
A         src/bat.c
A         src/baz.c
A         src/qux.c

bat.c 的修订版 8 复制到工作副本中的另一个名称下

$ svn copy -r 8 bat.c ya-old-bat.c
A         ya-old-bat.c

将工作副本中的项目复制到仓库中的 URL(这是一个立即提交,因此您必须提供提交消息)

$ svn copy near.txt file:///var/svn/repos/test/far-away.txt -m "Remote copy."

Committed revision 8.

将仓库中的项目复制到工作副本(这只会安排复制 - 直到您提交,才会将任何内容放入仓库)

$ svn copy file:///var/svn/repos/test/far-away -r 6 near-here
A         near-here
[Tip] 提示

这是恢复仓库中已删除文件的推荐方法!

最后,在两个 URL 之间复制

$ svn copy file:///var/svn/repos/test/far-away \
           file:///var/svn/repos/test/over-there -m "remote copy."

Committed revision 9.
$ svn copy file:///var/svn/repos/test/trunk \
           file:///var/svn/repos/test/tags/0.6.32-prerelease -m "tag tree"

Committed revision 12.
[Tip] 提示

这是在仓库中 标记 修订版的最简单方法 - 只需将该修订版(通常是 HEADsvn copy 到您的 tags 目录。

如果您忘记标记,也不要担心 - 您始终可以指定旧的修订版并在任何时候进行标记

$ svn copy -r 11 file:///var/svn/repos/test/trunk \
           file:///var/svn/repos/test/tags/0.6.32-prerelease \
           -m "Forgot to tag at rev 11"

Committed revision 13.