使用命令行 Subversion 访问项目源文件
命令行 Subversion 入门如果您参与的项目正在使用 Subversion 进行版本控制,您将需要使用 Subversion 访问和更改项目源文件。您可以点击项目的左侧导航窗格上的“Subversion”链接,在线浏览源代码以查看该项目的目录结构和文件。 “Subversion”页面显示三个子目录:branches/、tags/、trunk/ 和一个自述文件。自述文件可以使您对 Subversion 存储库有一个整体了解。您可以点击“访问选项”,查看 Subversion 客户端安装说明。您的本地计算机上必须安装有 Subversion 客户端。 获取项目的本地工作副本: 若要获取最新源文件的“工作副本”,您必须首先签出这些源文件,这一过程会将文件从存储库复制到您的系统中。在您的外壳程序或终端客户端,请键入: 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 操作时,请使用
处理 Subversion 存储库中的文件从项目存储库中签出本地副本后,您可以在本地计算机上编辑现有文件、创建新文件和目录、以及删除文件。在您将所做的任何更改提交回 Subversion 存储库之前,这些更改只对项目文件的本地副本起作用。 将工作副本中的文件/目录添加到存储库中: 在您第一次在工作目录中创建并编辑新文件后,可以将此文件添加到存储库中,或添加一个目录,目录中有无内容均可。 svn add FILENAME/DIR 。 这样就会在您的工作副本中添加文件/目录,并安排它们以添加到存储库中。您下次提交时,会上载这些文件/目录,并将它们添加到存储库中。如果您了添加内容,但在提交前又改变了主意,则可以使用 转换:--targets FILENAME, --non-recursive (-N), --quiet (-q), --config-dir arg, --auto-props, --no-auto-props 请参见添加文件/目录示例。 查看带有修订和作者信息的特定文件的内容: 若要在线查看指定文件的作者和修订信息,请键入: svn blame FILENAME 每行文本的开始处都以上次更改该行的作者(用户名)和修订版本号作为批注。 转换:--revision (-r) REV, --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR 查看特定文件的内容: 有时,与存储库相比较,您的工作副本可能已过时;或者您可能已修改了本地工作副本。在这些情况下,在提交更改或决定编辑您的工作副本之前,您会希望查看指定文件的内容差异。运行 转换:--revision (-r) REV, --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR 清理工作副本: 有时可能会出现“工作副本已锁定”错误。若要删除锁定,并递归清理工作副本,请使用 转换:--diff3-cmd CMD, --config-dir DIR 请参见 复制工作副本或存储库中的文件或目录: 在项目中,您可能需要用到过去的旧文档。例如,您可能想要使用一个已存在的 HTML 文件,使用其代码作为参考以在创建新内容时保持产品外观和感觉。创建文件时,您无需从头开始,只需使用 转换:--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 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 [-r REV] [PATH] 该命令将从 URL 指定的存储库中的修订版本 REV 位置(如果指定,否则从 HEAD 位置)将空目录树导出到 PATH。如省略 PATH,则该 URL 的最后一部分将用作本地目录名称。除此之外,您也可以在本地计算机内部,从一个工作副本(由 PATH1 指定)向另一工作副本(由 PATH2 指定)导出空目录树。这将保留所有的本地更改,但不会复制版本控制中的文件。若要执行此操作,请键入: svn export PATH1 PATH2
获取有关 Subversion 的帮助: Subversion 可以在命令行界面为您提供帮助。若要获得有关特定子命令的帮助,请键入: svn help [SUBCOMMAND...]
将您的更改提供给 SVN 存储库对文件和/或目录进行本地更改后,您必须向 SVN 存储库提交这些更改。 提交您的更改: 若要向共享存储库提交您的更改,请键入: 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 [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 打印有关工作副本中路径的信息: 有时,您将需要有关工作副本中文件的具体信息,以执行某些子命令。键入 转换:--targets FILENAME, --recursive (-R), --config-dir DIR 查看存储库中的目录项列表: 在开始处理项目或取出“工作副本”之前,您可能希望查看项目存储库中的内容(即目录和文件),或查看本地工作副本中的目录项。在命令提示符处键入 转换:--revision (-r) REV, --verbose (-v), --recursive (-R), --username USER, --password PASS, --no-auth-cache, --non-interactive, --config-dir DIR 查看提交日志信息: 如果要查看“工作副本”或存储库中文件/目录的各个文件/目录历史,以跟踪修订信息,请键入: 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 请参见 合并更改: 您可以运行 转换:--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 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 移动文件或目录: 您可以使用 转换:--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 具有很多具体属性,这些属性影响或决定其行为。您可以修改、提交和撤消属性更改,就像对文件内容所执行的操作一样。您还可以从本地工作副本或项目存储库的文件、目录或修订版本中,删除、编辑、打印、列出以及设置属性。 请参见 属性、无版本属性、元数据属性、 解决冲突: 更新本地工作副本时,可能会遇到冲突。您需要解决此冲突。解决冲突后,键入
请参见解决冲突(合并其他人的更改)。 撤消您的更改: 使用 Subversion 时,您会发现
注意,如不提供目标,会导致工作副本中的更改丢失。
获取文件/目录的状态: 在版本控制中,将更改提交到项目存储库之前最好对其进行审查。可以运行
请参见检查你的更改。 转换工作副本: 可以使用
请参见转换工作副本、分支和合并以及 更新工作副本: 为了进行更好的版本控制,建议您每天用项目存储库更新本地工作副本,请使用:
列出的已更新条目以及它们的当前状态显示如下:
分支和标记 项目的主干通常用作开发主线,而分支通常用作主线的变更。分支是正在进行的开发线。在软件开发生命周期中,如果软件产品的发布版本已到期,经常会用到分支,使测试者可以使用候选版本,使新的开发可以继续进行,不受测试的约束。分支还用于实验性工作,以及完成代码重写。标记是将一组文件修订版本标记为整体的方式。虽然分支和标记都是使用 本站点上您项目的 Subversion 存储库支持对您的源文件进行分支和标记。对于 Subversion 来说,标记和分支属于简单实用的“复制”操作。 若要创建分支或标记项目文件,请键入:
请参见分支和合并。 相关信息 |
|