SVN服务器及客户端安装配置使用手册

SVN服务器及客户端安装配置使用手册

湖南辰泰信息科技股份有限公司

2023-06-25

更改记录

归档编号更改情况简述提交人提交H期批准人批准H期

V0.01创建初稿袁奇2023/6/26

目录

l.SVN(Subversion)版本控制系统简介......................................................5

1.1什么是SVN(Subversion)..............................................................5

1.2为什么要用SVN........................................................................6

2.SVN服务器(VisualSVNServer)的安装、配置与使用说明..................................8

2.1SVN服务器软件VisualSVNServer的安装...........................................8

2.2SVN服务器软件VisualSVNServer的设立与使用...................................12

3.SVN客户端(TortoiseSVN)的安装、配置以及常用操作说明...............................18

3.1SVN客户端软件TortoiseSVN的安装与配置.......................................18

3.2SVN客户端软件TortoisoSVN的常用操作说明.....................................23

3.2.1导入项目初始的文档和源代码到SVN服务器................

322检出文档和源代码到本机...................................................25

3.2.3提交修改过的文献到SVN服务器...........................................28

3.2.4添加新文献到SVN服务器.................................

3.2.5更新本机代码与SVN服务器上最新的版本一致..............................31

3.2.6重命名文献或文献夹，并将修改提交到SVN服务器.......................28

3.2.7删除文献或文献夹，并将修改提交到SVN服务器...........................28

3.2.8使用SVN管理文献和源代码的注意事项....................................32

4.Eelipse集成SVN插件的安装配置以及操作说明..........................................34

4.1Eclipse集成SVN插件的安装配置方法.............................................34

4.1.1手动安装SVN插件........................................................34

4.1.2使用Eclipse安装向导安装SVN插件........................................35

4.2EclipseSVN插件的常用操作说明..................................................38

4.2.1初始导入项目，将本地项目导入到svn服务器版本库中.....................34

422检出项目源代码(checkout)................................................................................................43

4.2.3解决冲突.................................................................47

4.2.4创建分支(Branch).............................................................................................................50

4.2.5分支的合并...............................................................51

4.2.6还原(revert)至U历史版本..................................................53

5.VisualStudio.Net集成SVN插件的安装配置以及操作说明...............................54

5.1VisualStudio.Net集成SVN插件的安装配置........................................54

5.2VisualStudio.Net集成SVN插件常用操件说明......................................55

l.SVN(Subversion)版本控制系统简介

1.1什么是SVN(Subversion)

Subversion是一个自由、开源的版本控制系统。在Subversion管理卜，文献和目录可以超

越时空。Subversion将文献存放在中心版本库里。这个版本库很像一个普通的文献服务器,

不同的是，它可以记录每一次文献和目录的修改情况。这样就可以籍此将数据恢复到以前

的版本，并可以查看数据的更改细节。正由于如此，许多人将版本控制系统当作一种神奇

的“时间机器”。

Us>r3

有一个简朴但不十分精确比力：SVN=版本控制十备份服务器。简朴的说，你可以把

SVN当成你的备份服务器，更好的是，他可以帮你记住每次上传到这个服务器的文献内容,

并且自动的赋予每次的变更一个版本。通常，我们称用来存放上传文献的地方就做

Repositoryo用中文来说，有点像是文献仓库的意思。但是，通常我们还是使用

Repository这个名词。基本上，第一次我们需要有一个新增(add)文献的动作，将想要备份

的文献放到Repository上面。m后，当你有任何修改时，都可以上传到Repository上面,

上传已经存在且修改过的文献就叫做commit,也就是提交修改给SVNserver的意思。针对

每次的commit,SVNserver都会赋予他一个新的版本。同时，也会把每次上传的时间记录

下来。口后，由于某些因素，假如你需要从Repository下载曾经提交的文献。你可以直接

选择取得最新的版木，也可以取得任何一个之前的版本。假如忘掉了版本，还是可以靠记

忆尝试取得某个日期的版本。

1.2为什么要用SVN

版本工作及备份工作常见问题如下：

（1）备份工作文献是十分重要的。你永远不知道计算机二的硬盘何时会坏掉。根据经

验法则再加上摩菲定理，坏事情往往都发生在最重要的时刻。例如，要release东西的前

一刻，硬盘完全坏掉，无法修复。所以，经常备份工作数据是非常重要的。大部分公司的

server都会有专门的备份机制，甚至是异地备援。绝对比放在自己的计算机里头，或是随

身碟上面来的安全。

（2）版本控管非常重要。你无法保证手头上最新版本永远都是对的。很多时候，在通

过数天努力工作后，你才发现走错方向。需要将所有的修改回复到数天前版本。没有几个

人可以完全记住自己修改过什么东西。假如没有做好版本控管，那么，最差的状况就是要

所有重来。

（3）伙伴间的数据同步也是非常重要的。很多时候，除了你个人外，尚有其它的伙伴

也需要你的文献。怎么把最新的文献提供应伙伴呢？用e-mail?根据经验，用e-mail是

一个很差的办法。到了最后，主线就不知道哪一封e-mail才是新的。由于也许你最新的e-

mail已经被当成垃圾信给丢了。别忘了，现在很多e-mail软件都有anti-spam的功能，说

不定这些信件都被当成广告信给解决掉了。并且，你也应当知道一般文献假如放在e-mail

内，文献大小会变得比较大（通常是本来的4/3倍以上）。假如天天更新一次，恐怕几天

没收信的话，信箱就爆了！

（4）假如没有一个好的办法，备份不同版本是很花费硬盘空间的。例如：你有一个总

共10MB的目录，使用单纯的文献备份。假如有10个版本就会变成lOOMBo20个版本就有

200MBo假如，不想备份这么多版本，势必就是要减少备份的次数。拉长备份周期将会导致

数据遗失的危险性增高。把旧的不需要的备份删除？根据经验，只要时间一拉长，你跟本

就不知道一个月以前的版本是重要或者是不重要。

SVN能帮我们解决上面的问题吗？

答案是肯定的：

（1）SVNRepository可以是自己计算机上的一个目录，或者是移动硬盘（不建议这样用），当然也可以是

公司的服务器。

（2）SVN有很棒的版本控管机制。所有上传的版本都会帮你记录下来。日后你可以

随时取得某一个时刻的版本。并且，也有版本分支及合并等好用的功能。

（3）SVN可以让不同的开发者存取同样的文献，并且运用SVNServer作为文献同步

的机制。也就是说，你有文献更新时，无须将文献寄给你的开发成员。只需要告诉他新的

版本已经在SVNServer上面，请他自己去SVNServer上面就可以取得最新版本。并且SVN

Server也可以做到当你上传新版本后，自动发信给相关的成员。

(4)SVN的存放文献方式是采用差异备份的方式。也就是说，他只会备份有不同的地方。

所以很省硬盘空间。此外，他也可以针对所谓的非文字文献进行差异备份。

2.SVN服务器(VisualSVNServer)的安装、配置

与使用说明

2.1SVN月艮务器软件VisualSVNServer的安装

SVN服务器软件VisualSVNServer最新版本是2.7.7,安装文献可以在官网下载：

VisualSVNServer文档下载：

下载后，双击运营VisualSVN-Scrvcr-2.7.7.msi安装程序，点击Next按钮;

=＞名称

现SVN眼芬器以及客冷运安装配置手册vO.OJ.doc

j争LanguagePack_5475-win32-zh_CN.msi

LanguagePack_5475-x64-zh_CN.msi

j守TortoiseSVN-5475-win32-svn-1.8.9.msi

TortoiseSVN-5475-x64-svn-1.8.9.msi

闻VisualSVN-Server-2.7.7.msi

选中接受协议复选框，点击Next按钮;

按照默认的勾选,点击Next按钮:

选择StandardEdition（标准版），进入下一步

朝VisualSVNServer2.7.7Setup□

VisualSVNServerEditions

PleaseselectwhicheditionofVisualSVNServeryou'dBeetoinstall.

TherearetwoedtxxisofVisualSVNServeravailableanddependingonyourneedsyou

canchoosewhkhonesuitsyoubest

StandardEdition

Afullyfunctionalserverthatisgreatforindividualsandsmallgroups.Truly

freeofchargeandpermittedforcommercialuse.

EnterpriseEdtJon

ThebestoptionforSMBandenterprises.Providesadditionalfeaturessuchas

ActiveDirectorySingleSign-OnandRemoteServerAdministration.

CompareEditiors...

BackNextCancel

设立安装位置C:\ProgramFiles(x86)\VisualSVNServer\,文献仓库位置

E:\Repositories\,端口443(注：默认端口为443,假如报端口冲突，可以自行修改端标

语为9443或者其他端标语，后续访问也用此处设立的端标语即可)，使用安全连接，点击

Next按钮；

选择Install按钮，开始安装SVN服务器软件

总VisualSVNServer2.7.7Setup

□ReadytoInstall

TheSetupWizardisreadytobegin

ClickInstaltobegnthenstaHation.Ifyouwanttorevieworchangeanyofyour

installatxxisettings,dkkBack.ClickCanceltoexitthewizard.

Back[TSDCancel

安装完毕后，点击Finish按钮结束安装过程。

2.2SVN服务器软件VisualSVNServer的设立与使用

点击Windows系统开始菜单一程序一VisualSVN-VisualSVNServerManager,启动

SVN服务器管理工具。

。L.VisualSVNServer

在左边的Repositories上用鼠标右击，选择菜单项“CreateNewRepository”或者选

择-depository..."来创建一个新的项目版本库。

CreateNewRepository...

点击创建一个项目库

Browse

Properties...

新建(N)

所有任务(K)

频M

刷新(F)

导出列表(L).・・

帮助(H)

输入项目库名称，此处以项目“StartKit”为例，点击下一步

选择文献仓库结构，按照默认设立即可，点击下一步

VisualSVNServer

文件(F)掇作(A)至看(V)SSO(H)

♦♦岳国I昌昌I股而

设立文献仓库访问权限，初始化权限为“Nobodyhasaccess”，点击“Create

新建项目版本库

提醒项目版本库建立成功，点击Finish完毕项目建库的过程。

VisualSVNServer

文件(F)提作(A)SS(V)那助(H)

・♦I团画|l*G由I国因I5

创建完项目版本库后，没有任何内容在里面。我会在这个教程的后续部分说明如何迁入

文档、源代码以及其他文献的。

接下来我们新建用户，在左侧的Users上点击右键，选择"CreateUser...w：

iositories

CreateUser”.

新建(N)►U$er-

*i|

频M►

点击上面二处中的一

刷新(F)

处，创建一个新用户

导出列表(L)...

帮助(H)

输入用户名、密码，确认密码信息，点击0K,我们就创建一个用户了。

—

CreateNewUser1>.

Username:如如榆入用户名

Password:....输入番码

Confirmpassword:••••••确认密码

|OUsernameandpasswordarecasesensitive.

注意：密码和用户名区分中小写

[OK|[Cancel

按照上面的过程,分别添加其他用户（例如：dcvelopcrl.testeri.manageri等）。接

下夹我们在刚才创建的项目仓库对这些用户进行授权，右键点击StartKit项目库，选择菜

单项Properties...w,进入如卜,界面：

点击上图中的〃Add...〃按钮，在下图中选择我们刚才添加的用户，点击0K按钮。说明：大

家也许注意到了下图中的Groups,是的，你也可以先创建组，把用户添加到各个组中，然

后对组进行授权，操作比较简朴，在此略过。

按照下图所示，分别对用户或组进行授权:

点击〃拟定〃按钮，上面的用户就具有了访问StartKit项目版本库的不同权限。

由于用户starter在团队中是新来者，不希望他向代码库中提交新代码，所以他只能读

取代码库中的代码，不能提交代码。tested是测试人员，不负责代码编写，所以也是只读

权限。而developerl和managerl是开发人员和项目经理，自然具有读、写的权限。在实

际的项目开发过程中，developer和tester往往不也许只有一个人，参与项目开发管理的

人员多的时候使用组来授权更加方便，这个大家可以自己练习一下。

3.SVN客户端(TortoiseSVN)的安装、配置以及

常用操作说明

3.1SVN客户端软件TortoiseSVN的安装与配置

最新版本是1.8.7,你可以在这里下载：

简体中文语言包下载：

TortoiseSVN中文资料：

下载后，会有64位和32位的版本请根据自己机器操作系统的情况自行选择相应的版本

安装

名称

EJSVN眼芬器以及客士途安装配置手册vO.OJ.doc

LanguagePack_5475-win32-zh_CN.msi

LanguagePack_5475-x64-zh_CN.msi

j守TortoiseSVN-1.8.7,25475-win32-svn-1.8.9.msi

、周TortoiseSVN-5475-x64-svn-1.8.9.msi

VisualSVN-Server-2.7.7.msi

双击运营TortoiseSVN-5475-x64-svn-1.8.9.msi程序，点击Next,下面的截图顺序即为安装环节:

TortoiseSVN5475(64bit)Setup

N

WelcometotheTortoiseSVN

>5475(64bit)Setup

SWizard

8

STheSetupWizardwilmsWITortoseSVN5475(64

bit}onyoutcomputer.CWcNexttocontinueorCanedto

O-exittheSetupVnzard.

+

O」

LJ

<BackjNext〉15cd

选择接受协议,然后点击Nexi按钮,进入下一屏

选择要安装的组件以及安装的位置，然后点击Next按钮

点击Install按钮开始安装文献。

单击Finish按钮，元毕TortoiseSVN的女装

TortoiseSVN5475(64bit)Setup13

N

CompletingtheTortoiseSVN

>5475(64bit)Setup

SWizard

OdetheFinishbuttontoexittheSetupVAwd.

IQS>

O・ShowChangdog

+ThanksforushgTorto®eSVN.Youcanshowyour

」appeeoattonandsuppppoxrtfuturedevetoomentby

Odonating'

1Donate*

<BaccIFinishCaned

接下来双击运营LanguagePack_l.8.7.25475-x64-zh_CN.msi安装简体中文语言包，单

击Next按钮

》却"TortoiseSVNChinese,simplified"Setup

Welcometothe"TortoiseSVNChinese,

simplified"SetupWizard

TheSetupVizard*1instolTortoiseSVNChnese,sripWied"

onyourcomputer.CkkNexttoconbnueorCanceltoexit

theSetLpWizard.

开始安装相关的语言包文献，单击Finish按钮结束语言包安装过程。

"TortoiseSVNChinese,simplified*Setup

N

CompletedtheTortoiseSVNChinese,

>simplified'SetupWizard

S

8

打开Windows资源管理器，在右边文献夹的空白区域点击鼠标右键，在弹出的右键菜单

里面选择TortoiseSVN,然后选择Settings菜单项，进入设立界面

Snaglt________________________

SVNCheckout-.

TortoiseSVN

mI一

pAddtoarchive.

Addto,StartKitrar"

mU

iCompressandemail-

phCompressto,StartKit.rar'andemail

laGrooveFolderSynchronization

酮嫡的版本W

清空回收站⑻

ScanselectedfileswithAntMr

在设立界面，Language选择“中文（简体）”，先点击“应用”按钮，再点击“拟

定”按钮完毕语言设立。

3.2SVN客户端软件TortoiseSVN的常用操作说明

安裳好SVN客户端TortoiseSVNJS,接下来说明TortoiseSVN的使用方法。

3.2.1导入项目初始的文档和源代码到SUN服务器

假如我们在自己本机的文献夹StartKit中创建了一个项目，我们要把这个项目的文档

以及源代码签入到SVNServer上的项目版本库中里，一方面右键点击StartKit文献夹，

这时候弹出右键菜单“TortoiseSVN”--“导入...”，点击“导入...”菜单项，弹出下面

的窗体，：

其中https:〃yuanqi-pc:9443是服务器名(注意此处地址为文档演示地址，实际SVN

服务器地址为:443),svn是代码仓库的根目录，StartKit是我们在前面操作中添加的一

个项目版本库。

说明：左下角的复选框，在第一次签入源代码时没有用，但是，在以后你提交代码的时

候是非常有用的。

点击确认按钮，会弹出下面的窗体，规定输入认证凫据：

E:\StartKit-导入-TortoiseSVN

认证

撵作路径

命令导入E:\StartKit至

,--------------需要用户名而密码----------------

用户名(U)：developer1

理码(P)：......,

(百麟温回

任喻中•速度(…定⑼取消

碓(Q)取消

在上面的窗体中输入用户名和密码(勾选保存认证项以后无需再次输入用户名和密码)，

点击确认按钮：

导入完成！-口^■

操作路径

正在增加E：StartKit\中国建行四JI省分行成都中心金库流水线欣件圮字号码管理系线04.版本发布及补丁记录02

正在堪加E:$tartKt\中国建行四JI省分行成都中心金库流水线欹件足字号码管理系统VJ4.版本发布及补丁记录Ye

正在姆加E:%tarKt\中国建行四JI由分行成都中心全后流水线欹件凫字号码管理系统VM.版本发布及补丁记录顺

正在增加巳\5匕「的八中国电行四II倘分行成都中心金底流水线船件国字号码警理系换\code

正在增加E:0arKt\中国建行四JI窗分行成都中心金库流水线砍件状屏藕显示软件

正在增加巳6间凶八中国建行四川省分行成都中心金库流水线欣件快入终端软件

正在增加E:\$tarMt\中国澧行四川省分行成都中心金库流水线物件供箱软件

完毕于版本:1

跳过：“已增加：90(确定(Q)]]取消

如上图所示，项目初始的文当和代码已经成功导入SVN服务器了。这时候在服务器上可

以看到如下版本库结构。相关团队成员也可以检出SVN服务器上的文档和源代码到自己的

机器了。

RMDmn（A）M（V）MKXH）

坛♦:匕词I。》

»ViwialSVNServera<x«l）（httpW/Ygnqi-PC;944

，*R<p5iCO，i・*

中0・行S3川宣分行成・中心金QiJVM4

/-口~GJ02K3

">QjOCRiRWttftCJOJJMXTS

LJ04*ERtt*及扑丁记录A

>QjPtcim

口code

：•Uiww超方g«x

•一jin手W苫理察0

・GJ01.WB

»CJ01«BHUxrM

,Qj02,求分帐m*

»QjOMMiftrHnift

»CJ

♦U

»QJOOBSfc后誉一险

»CJ07!»rjietAryie

♦QjoeJ5HW®ii«

♦GJg叽RWicnB

»口lox^stm

♦CJ11•学史”

»Qj。2TOK*

t>CJ03««£&S

b004J®/次丁8

Jcode

二J录入修■«住

215…

.JGroup*

3.2.2检出文档和源代码到本机

在本机创建文献夹SlarlKit,右键点击弹出菜单，选择“SVN检出”菜单项，弹出如下

图的窗体：

在上图中版本库URL:输入svnserver中的代码库的地址(注意此处地址为文档演示

地址，实际SVN服务器地址为:443),其他默认，点击拟定按钮，就开始检出文档和源代码

了。

说明：上图中的检出深度，有4个选项，分别是全递归（所有）、直接子节点包含文献

夹、仅文献子节点、仅此项，默认的是第一项。

]A，[SsrtKit

so*wasai0s大小

▲ez，行&III・分行•汽水城20U624■&-文0st

把3

上面的例子中，我们也可以使用web的方式访问代码库，在浏览器中输入

https://yuanqi-pc:9443/svn/StartKit/

这时候也会弹出对话框，规定输入用户名和密码，通过验证后即可浏览代码库中的内

容。

至此项目相关的文档和源代码已经成功签出到刚才新建的StartKit目录中。

打开StartKit目录，可以看到如下图的文献夹结构:

•tI，道白至IB，TS2APP。)，SurtKit»eWt行W川・分行或够料。^像好，

>XBKA产->修改已明

。■如1|S

JiocR^eawt2014624M..

)上下我

.ptccn2014-6-24M..

)M育里>XJWITTIW2014-6-24M..S

2014624M..

%TS1.WIN©上圣入懦im2014-6-24•IT

(Adu412014-624M..

,jTS2JSP(D0

上9”8

MgzhJtp

卜,myug

上MyOrivers

Jl

▲ProgramFiles

_|蚪

•旦你对文献或文献夹做了任何修改，那么文献或文献夹的显示图片机会发生变化。下

图中修改了其中的一个文献“SVN结构.txt”：

中国建行四JII省分行成都中心金库流水线

共享»6

，这£电箱►TS2.APP(D:)►StartKh►中国3行臼川IS分行成都中。全龄I水违次爱♦=国建

□

•下戴Q_

■W面svNisig.SJKl.txt

上国涧的位置txt

4豕位相

，:电这融脑

.胸

4剪片

•下戴

>D含东

>・点面

jLTS1.W1N(C:)

jTS2.APP(D:)

jWD1.DOC(E:)

昨同珞

大家看一下不同状态所相应的图片:

设置-TortoiseSVN

A案般没笆

->版本分立图

A版本图至后集(I):XPStylev

；”假色

R图泛覆盖，.常规®无版本控制.cpp&忽BB.txt加.doc

O.修改况笨现h0,无板翻制M星忽咯.doc

£)55羡程序A小奖<L修设.h0常理java也无6本拄制doc

9网络。不读4冲突.h<h修改java区常照pl

Q差异查看器M5®除ftjRiS.h却冲突.java£修改.pl

丫差异查百/台并工具人啮匕已1ft除h0R读.java£冲突M

*18加SlttS.hSe®叫ava也具读M

■A常规

)。上下文菜单4忽略*；«ZE.hd噫JavaJL已删除•pl

❷无质本控制0忽略h如丽沁a£»€Enl

力对话楂殂一

4.常现xpp.无ffi本拄MhJ忽鬲,java也闻J。.pl

j：：对二

Q修改.cpp㈤总现.txtQ,无位本控制Java&SM.pl

:WkJ陵.cppQ；修改E厚，规.doc❷无版本控制.pl

•3通用dR读.cpp£|冲突E值修改.doc分常规.php

对话低3XBfJSJf.cppWi只读.txt亚冲为doc5修改php

仔已保^3384Ltt^cppK己也除txt电设iS.doce浦类.php

<□日志漫存缸18Mcpp置lfcS2.txt醐BS!险doc®只读.php

ESK.cpp屈曲C.txtIgS^.doc必£9!他php

-;C滚存的根本左

，孑均子静本<>

.问成

⑥*衰现图(l)。符快随⑸

乐TortoiseBlame

ASiS

确是取僧赢

我们已经知道怎么将源代码签入到SVN服务器，怎么从服务器签出代码到本机,也简朴了

解了不同状态所相应的图案啦。

3.2.3提交修改过的文献到SVN服务器

上一小节中，我们修改了本地机器位于"D:\StartKit\中国建行四川省分行成都中心金

库流水线”文献夹中的一个文献“SVN结构.1x1”，下面演示如何提交到SVN服务器。

注意：提交文档或者源代码到服务器时，一定保证本机的文档或者代码是最新版本，否

则乜许提交失败，或者导致版本冲突。

在“中国建行四川省分行成都中心金库流水线”文献夹上点击右键或在