Subversion(SVN) 是一个开源的版本控制系統，管理着随时间改变的数据。这些数据放置在一个中央资料档案库(repository) 中。这个档案库很像一个普通的文件服务器, 不过它会记住每一次文件的变动。这样你就可以把档案恢复到旧的版本, 或是浏览文件的变动历史。
与之类似的还有 CVS 与 Git，CVS 已经淘汰，不再赘述。SVN是集中式，Git是分布式。
术语
- Repository (存储库): 统一存放源代码
- Checkout (检出): 从远程存储库拉取代码
- Commit (提交): 推送本地变动至远程存储库
- Update (更新): 同步远程存储库变更
关系图
![[1654966063189.jpg]]
基本使用
创建存储库
存储库相当于一个集中的空间，用于存放开发者所有的工作成果。版本库不仅能存放文件，还包括了每次修改的历史，即每个文件的变动历史。
Create 操作是用来创建一个新的存储库，只有管理员才能进行此操作。当你创建一个新的存储库时，需要向版本控制系统提供一些信息以标识存储库，例如创建位置和存储库名称。
检出
Checkout 操作用来从版本库创建一个工作副本。工作副本是开发者私人的工作空间，可以进行内容的修改，然后提交到远程存储库中。
|
|
svn://192.168.0.1/runoob01 为远程存储库地址，末尾 project01 用于指定存储库保存在本地的名称。
添加 --depth 参数可指定要检出的深度，以下示例仅从存储库中检出一个空目录，不包含其下的文件及目录。
|
|
添加
将文件/目录添加到存储库中。
|
|
将文件/目录添加到存储库中，自动忽略先前已加入存储库的文件/目录。
|
|
更新
Update 操作用于同步远程存储库，这个操作将工作副本与远程存储库进行同步。存储库是由整个团队共用，当其他成员提交改动之后，本地工作副本就会过期（与远程库内容不一致），进而需要进行同步。
|
|
添加 -r 参数可指定更新到的目标版本，例如 -r6 表示更新到版本 6。
提交
当检出存储库之后，可以对工作副本中的数据进行编辑、删除、重命名、添加文件/目录等操作。但是这些变动不会立刻应用到远程存储库，而是被添加进待变更列表中，直到执行 commit 操作后才会被应用到远程存储库。
|
|
查看变动
检出工作副本或者更新工作副本后，,对工作副本进行的一些修改，会使工作副本与远程存储库数据出现差异，Status 操作列出了工作副本中所有的变动。在 commit 操作之前复查下变动是一个很好的习惯。
工作副本的任何改动都会成为待变更列表的一部分，不需要手动执行 add 操作。
|
|
添加 --no-ignore 参数，可查看包含已忽略文件/目录的待变更列表。
回退
Revert 操作恢复对工作副本的修改。其可以恢复一个或多个文件/目录，也可以恢复整个工作副本。恢复整个工作副本时，将会销毁待变更列表并将工作副本恢复到原始状态。
|
|
忽略文件/文件夹
查看当前目录的忽略规则，可在最后添加径指定要查看的目录。
|
|
编辑当前目录的忽略规则，可在最后添加径指定要编辑的目录，--editor-cmd 参数用于指定要使用的编辑器。
|
|
忽略当前目录下名称为 ignoreThis.txt 文件。
|
|
忽略当前目录及其子目录中名称为 ignoreThis.txt 的文件。
|
|
根据配置文件忽略文件或目录：
|
|
-F 指定配置文件，-R 表示同时将忽略规则应用到所有子目录，末尾的 . 表示要应用到的路径（示例中是当前目录）。
删除文件/目录
从本地以及存储库中删除文件/目录。添加 --keep-local 参数可指定仅删除存储库中的文件/目录，保留本地文件。
|
|
其他
- svn log: 用来展示svn 的版本作者、日期、路径等等。
- svn diff: 用来显示特定修改的行级详细信息。
- svn cat: 取得特定版本的某文件数据并显示在当前屏幕。
- svn list: 显示一个目录或某一版本存在的文件。
杂项
将变更提交至远程存储库时，如果版本不一致，将需要进行合并 (Merge) 操作，SVN 会自动处理可以安全合并的行，其它的会被当做冲突。例如，“hello.c” 文件在一个分支上被修改，在另一个分支上被删除了。这种情况就需要人为处理。Resolve 操作就是用来帮助用户找出冲突并告诉版本库如何处理这些冲突。
SVN 以行为单位管理源代码，多个工程师只要不是修改了同一行，SVN 都能够自动合并修改。如果修改到同一行，SVN 会提示文件 Conflict (冲突)，需要手动合并。