This text is a work in progress—highly subject to change—and may not accurately describe any released version of the Apache™ Subversion® software. Bookmarking or otherwise referring others to this page is probably not such a smart idea. Please visit http://www.svnbook.com/ for stable versions of this book.
svn list (ls) — 列出仓库中的目录项.
svn list [
TARGET
[@REV
]...]
列出仓库中的每一个 TARGET
文件和
TARGET
目录的内容. 如果
TARGET
是一个工作副本路径, 命令将自动使用
工作路径的 URL.
TARGET
的默认值是
“.
”, 即当前工作副本目录在仓库中的
URL.
如果带上了选项 --verbose
(-v
),
svn list 将额外显示项目的如下字段:
最近一次提交的版本号
最近一次提交的作者
如果文件被锁定了, 则显示字母 “O” (更多的细节 见前面的 svn info
大小 (以字节为单位)
最近一次提交的日期和时间
如果添加了选项 --xml
, 输出将会是 XML 格式
(带有头部信息和封闭的文件元素, 除非还添加了选项
--incremental
), 所有的信息都会被呈现出来, 但
此时不能再使用选项 --verbose
(-v
).
如果你想查看仓库里有哪些文件, 但又不想检出工作副本, 那么 svn list 就显得很方便了:
$ svn list http://svn.red-bean.com/repos/test/support README.txt INSTALL examples/ …
如果你想查看更多的信息, 就添加选项 --verbose
,
就像 Unix 命令 ls -l:
$ svn list -v file:///var/svn/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/
添加选项 --xml
后, svn list
将以 XML 格式显示输出:
$ svn list --xml http://svn.red-bean.com/repos/test <?xml version="1.0"?> <lists> <list path="http://svn.red-bean.com/repos/test"> <entry kind="dir"> <name>examples</name> <size>0</size> <commit revision="24"> <author>harry</author> <date>2008-01-18T06:35:53.048870Z</date> </commit> </entry> ... </list> </lists>
更多的信息见 “列出被版本控制的文件”一节.