幕雪

svn怎么使用：从入门到进阶的全方位指南

引言：SVN——您的代码管理利器

在软件开发、文档协作乃至网站内容管理的日常工作中，我们经常会遇到这样的问题：如何管理文件的多个版本？如何在团队中高效协作，避免文件覆盖？如何在代码出现问题时快速回溯到之前的稳定版本？这些疑问的答案，都指向了版本控制系统（Version Control System）。而SVN（Subversion）正是其中一款广受欢迎且功能强大的集中式版本控制系统。

SVN是什么？

SVN，全称Subversion，是一个开源的版本控制系统。它主要用于跟踪和管理文件、目录的变更历史。简单来说，它就像一个“时光机”，能够记录项目中的每一次改动，包括谁在什么时候修改了什么内容，并允许您在需要时轻松地查看、比较甚至恢复到任何一个历史版本。

为什么选择SVN？

那么，在众多版本控制系统中，为什么许多团队和项目仍然选择SVN呢？

  • 集中管理： SVN采用集中式架构，所有版本的历史数据都存储在中央服务器上。这使得项目管理员可以方便地统一管理权限和数据备份，对于小型到中型团队来说，上手和维护成本相对较低。
  • 版本追溯： 每一笔提交（Commit）都会被完整记录，包含提交者、时间、提交信息以及所有改动的文件。您可以随时查看项目的任何历史状态。
  • 错误恢复： 如果不小心修改了错误的代码，或者新功能引入了问题，SVN允许您轻松地回滚到之前的任何一个稳定版本，极大地降低了开发风险。
  • 团队协作： 团队成员可以并行工作，各自修改不同文件或同一文件的不同部分。SVN能够帮助合并这些修改，并提供冲突解决机制，确保代码集成顺畅。
  • 文件锁定： 针对二进制文件（如设计图、Office文档等），SVN支持独占锁定功能，确保同一时间只有一个用户可以修改，避免二进制文件合并困难的问题。

一、SVN服务器的搭建与配置

要使用SVN，首先需要有一个存储版本库的服务器。SVN可以在多种操作系统上部署，这里我们介绍两种常见的搭建方式：

哪里可以部署SVN服务器？

SVN服务器可以部署在Windows、Linux、macOS等操作系统上。对于不同平台，有不同的工具和方法。

Windows平台：使用VisualSVN Server

VisualSVN Server是一个在Windows环境下搭建SVN服务器的优秀解决方案，它集成了Apache和SVN，提供了图形化界面管理，非常适合初学者。

  1. 下载安装： 访问VisualSVN Server官方网站，下载最新稳定版安装包，并按照安装向导一步步完成安装。安装过程中，您可以选择默认安装路径，端口号，以及是否启用安全证书（HTTPS）。
  2. 创建版本库（Repository）： 安装完成后，打开VisualSVN Server Manager。在左侧导航栏，右键点击“Repositories”，选择“Create New Repository…”。
  3. 选择类型： 通常选择“Regular FSFS repository”。
  4. 命名版本库： 为您的版本库起一个名称，例如“MyProject”。
  5. 选择结构： 建议选择“Standard (trunk, branches, tags)”，这是一种业界推荐的项目结构，方便日后分支和标签管理。
  6. 设置权限： 版本库创建后，您可以为用户或组设置读写权限。在版本库名称上右键，选择“Properties” -> “Security”选项卡，添加用户并分配权限。

注意： 如果您的服务器有防火墙，需要确保SVN服务所使用的端口（默认为443或80）对外开放。

Linux平台：使用svnserve或Apache+mod_dav_svn

在Linux环境下，您可以使用更轻量级的svnserve，或者通过Apache服务器集成mod_dav_svn模块。

方法一：使用svnserve (轻量级)
  1. 安装SVN： 打开终端，使用包管理器安装Subversion。
    • Debian/Ubuntu: sudo apt update && sudo apt install subversion
    • CentOS/RHEL: sudo yum install subversion
  2. 创建版本库： 选择一个目录存放版本库，例如/srv/svn。 
    sudo mkdir -p /srv/svn/MyProject
sudo svnadmin create /srv/svn/MyProject
  3. 配置访问权限： 进入版本库的conf目录 (/srv/svn/MyProject/conf)。
    • 编辑svnserve.conf： 
      anon-access = none  # 禁止匿名访问
auth-access = write # 认证用户可写
password-db = passwd # 密码文件
authz-db = authz   # 权限文件
realm = My Project Repository # 认证域名称
    • 编辑passwd（添加用户）： 
      [users]
user1 = password1
user2 = password2
    • 编辑authz（配置权限）： 
      [groups]
developers = user1,user2

[MyProject:/]
@developers = rw # developers组对根目录有读写权限
  4. 启动svnserve： 
    svnserve -d -r /srv/svn

    此命令将svnserve作为守护进程运行，根目录设置为/srv/svn。客户端访问地址将是svn://<服务器IP>/MyProject。

方法二：使用Apache + mod_dav_svn (功能更强大，支持HTTP/HTTPS)

这种方式可以利用Apache的强大功能，例如通过HTTP/HTTPS协议访问，支持LDAP认证等。

  1. 安装Apache和mod_dav_svn：
    • Debian/Ubuntu: sudo apt install apache2 libapache2-mod-svn
    • CentOS/RHEL: sudo yum install httpd mod_dav_svn
  2. 创建版本库： 同svnserve方式。
  3. 配置Apache： 编辑Apache配置文件（例如/etc/httpd/conf.d/subversion.conf或在apache2.conf中添加）。 
    <Location /svn>
    DAV svn
    SVNParentPath /srv/svn  # SVN版本库的父目录
    AuthType Basic
    AuthName "Subversion repositories"
    AuthUserFile /etc/svn-users  # 用户密码文件
    Require valid-user
</Location>
  4. 创建用户密码文件： 
    sudo htpasswd -cm /etc/svn-users user1 # 首次创建使用-c
sudo htpasswd -m /etc/svn-users user2 # 添加新用户不使用-c
  5. 重启Apache：
    • Debian/Ubuntu: sudo systemctl restart apache2
    • CentOS/RHEL: sudo systemctl restart httpd

    客户端访问地址将是http://<服务器IP>/svn/MyProject。

二、SVN客户端的准备与基础操作

服务器搭建完成后，客户端就可以连接并使用了。

SVN客户端如何安装？

最常用的SVN客户端有Windows上的TortoiseSVN和各平台通用的命令行客户端。

Windows平台：TortoiseSVN

TortoiseSVN是Windows下最流行、最易用的SVN图形化客户端，它与Windows资源管理器无缝集成。

  1. 下载安装： 访问TortoiseSVN官方网站，下载对应您操作系统位数（32位或64位）的安装包。
  2. 安装过程： 双击安装包，按照提示一步步完成安装。安装完成后，通常需要重启电脑或注销再登录一次，以便TortoiseSVN的右键菜单集成生效。
  3. 语言包： 如果需要中文界面，可以在官网下载并安装对应的语言包。

Linux/macOS平台：命令行客户端

在Linux和macOS上，SVN命令行工具是原生且最常用的方式。

  1. Linux安装： 大多数Linux发行版预装了SVN，如果没有，可以通过包管理器安装：
    • Debian/Ubuntu: sudo apt install subversion
    • CentOS/RHEL: sudo yum install subversion
  2. macOS安装： macOS通常需要安装Xcode Command Line Tools： 
    xcode-select --install

    或者通过Homebrew安装：

    brew install svn

提示： 命令行操作虽然没有图形界面直观，但效率更高，且适用于自动化脚本。

首次接触：如何检出（Checkout）项目？

检出是将服务器上的版本库内容下载到本地工作副本（Working Copy）的第一步。

TortoiseSVN操作：

  1. 在您希望存放项目的本地文件夹中，右键点击空白处。
  2. 选择“SVN Checkout…”。
  3. 在“URL of repository”中填入服务器版本库的地址（例如：https://your-server-ip/svn/MyProject/trunk 或 svn://your-server-ip/MyProject/trunk）。
  4. 在“Checkout directory”中确认本地路径。
  5. 点击“OK”。系统可能会要求您输入用户名和密码。

命令行操作：

svn checkout <版本库URL> <本地目录名>

例如： 

svn checkout https://your-server-ip/svn/MyProject/trunk MyProject

如果未指定本地目录名，SVN会自动创建一个与版本库最后一个路径段同名的目录。

日常更新：如何更新（Update）代码？

更新操作是将您本地的工作副本与服务器上的最新版本同步，获取其他成员的提交。

TortoiseSVN操作：

  1. 在您的工作副本根目录上右键点击。
  2. 选择“SVN Update”。
  3. TortoiseSVN会显示更新进度，并告知是否有新的文件或冲突。

命令行操作：

进入您的工作副本根目录： 

cd MyProject
svn update

修改与提交：如何提交（Commit）您的更改？

提交是将您本地的修改（新增、修改、删除等）上传到服务器，使其成为版本库历史的一部分。

TortoiseSVN操作：

  1. 在您的工作副本根目录（或包含修改文件的特定文件夹）上右键点击。
  2. 选择“SVN Commit…”。
  3. 在弹出的对话框中，您会看到所有已修改、新增、删除等状态的文件。
  4. 在“Message”区域填写本次提交的详细信息（非常重要！清晰的提交信息有助于日后追溯）。
  5. 勾选您想要提交的文件。
  6. 点击“OK”。

命令行操作：

  1. 进入您的工作副本根目录： 
    cd MyProject
  2. 查看本地修改状态： 
    svn status

    （M表示修改，A表示新增，D表示删除，?表示未版本控制）

  3. 提交更改： 
    svn commit -m "您的提交信息"

    （如果您只想提交特定文件，可以指定文件路径：svn commit -m "您的提交信息" file1.txt folder/file2.py）

文件管理：如何添加、删除、移动和重命名文件？

在SVN中，对文件的这些操作也需要通过SVN命令来通知版本库。

添加（Add）新文件或目录：

当您在工作副本中创建了新文件或新目录后，它们默认是不受SVN控制的。

TortoiseSVN操作：
  1. 在新文件或新目录上右键点击。
  2. 选择“TortoiseSVN” -> “Add”。
  3. 文件或目录图标会变为带加号的状态，表示已添加到版本控制队列，等待提交。
命令行操作：
svn add <文件或目录路径>

例如： 

svn add new_file.txt
svn add new_directory/

添加后，需要进行svn commit才能将这些更改提交到服务器。

删除（Delete）文件或目录：

TortoiseSVN操作：
  1. 在要删除的文件或目录上右键点击。
  2. 选择“TortoiseSVN” -> “Delete”。
  3. 文件或目录图标会变为带叉号的状态，表示已标记为删除，等待提交。
命令行操作：
svn delete <文件或目录路径>

例如： 

svn delete old_file.txt
svn delete old_directory/

删除后，同样需要进行svn commit。

移动/重命名（Move/Rename）文件或目录：

在SVN中，移动和重命名是同一个操作，SVN会跟踪文件的历史。

TortoiseSVN操作：
  1. 在要移动/重命名的文件或目录上右键点击。
  2. 选择“TortoiseSVN” -> “Rename…” 或“Move versioned item here…”（拖拽时按住右键）。
  3. 输入新的名称或选择新的路径。
  4. 完成后，文件图标会变为带箭头，表示已重命名/移动，等待提交。
命令行操作：
svn move <原路径> <新路径>

或简写为： 

svn mv <原路径> <新路径>

例如（重命名）： 

svn mv old_name.txt new_name.txt

例如（移动）： 

svn mv file.txt sub_folder/file.txt

移动/重命名后，也需要进行svn commit。

三、SVN进阶使用技巧

版本追溯：如何查看历史记录（Log）？

查看提交历史是了解项目进展、查找问题根源的关键。

TortoiseSVN操作：

  1. 在工作副本的任何文件、文件夹或根目录上右键点击。
  2. 选择“TortoiseSVN” -> “Show log”。
  3. 弹出的日志窗口会显示所有提交记录，包括版本号、提交者、日期、提交信息以及受影响的文件列表。您可以双击某个提交查看更详细的修改内容。

命令行操作：

svn log <文件或目录路径>

例如： 

svn log # 查看整个工作副本的日志
svn log index.html # 查看特定文件的日志
svn log -l 5 # 只显示最近5条日志
svn log -r 100:200 # 显示版本100到版本200的日志

差异对比：如何比较（Diff）文件内容？

比较文件差异可以帮助您理解代码改动，尤其是在审查代码或解决冲突时。

TortoiseSVN操作：

  1. 在已修改的文件上右键点击。
  2. 选择“TortoiseSVN” -> “Diff with previous version”（与上一版本比较）或“Compare with BASE revision”（与当前工作副本的基准版本比较）。
  3. 您也可以选择两个不同版本的文件进行比较：在日志窗口中选择两个版本，右键点击，选择“Compare revisions”。
  4. TortoiseSVN会启动一个差异比较工具（例如TortoiseDiff），以颜色高亮显示增删改行。

命令行操作：

svn diff <文件路径> # 比较本地修改与基准版本
svn diff -r <版本号1>:<版本号2> <文件路径> # 比较两个特定版本间的差异
svn diff -r HEAD <文件路径> # 比较当前本地修改与服务器最新版本差异

例如： 

svn diff index.html
svn diff -r 123:124 main.py

错误挽回：如何回滚（Revert）更改？

回滚可以将本地尚未提交的修改撤销，或者撤销服务器上已提交的某个版本。

回滚本地未提交的修改：

TortoiseSVN操作：
  1. 在工作副本的根目录或特定文件/文件夹上右键点击。
  2. 选择“TortoiseSVN” -> “Revert…”。
  3. 在弹出的对话框中勾选您想回滚的文件，点击“OK”。
命令行操作：
svn revert <文件或目录路径>

例如： 

svn revert broken_code.py # 撤销对broken_code.py的本地修改
svn revert -R . # 撤销当前目录下所有本地修改（慎用）

回滚已提交的某个版本（撤销提交）：

如果某个提交引入了问题，您需要撤销它。这通常通过合并（Merge）一个反向的差异来实现。

TortoiseSVN操作：
  1. 在工作副本根目录上右键，选择“TortoiseSVN” -> “Show log”。
  2. 找到您要撤销的提交（例如版本号R123）。
  3. 右键点击该提交，选择“Revert changes from this revision”。
  4. TortoiseSVN会生成一个反向差异，将其应用到您的工作副本中。
  5. 重要： 回滚操作完成后，您需要在本地进行一次新的commit，将这个“撤销”操作提交到服务器，形成新的版本。
命令行操作：
svn merge -c -<要撤销的版本号> <版本库URL> <工作副本路径>

例如，要撤销版本R123的提交，在工作副本目录执行： 

svn merge -c -123 https://your-server-ip/svn/MyProject/trunk .

然后提交： 

svn commit -m "Reverted changes from revision 123 due to bug X."

协作基石：如何解决冲突（Conflict Resolution）？

当两个用户修改了同一个文件的同一行或同一区域，并且都提交到服务器时，SVN在您更新（Update）时会报冲突。

TortoiseSVN冲突解决：

  1. 当您执行“SVN Update”时，如果遇到冲突，TortoiseSVN会弹出提示，冲突的文件图标会显示红色感叹号。
  2. 在冲突文件上右键点击，选择“TortoiseSVN” -> “Edit Conflict”或“Resolve Conflict”。
  3. TortoiseSVN会启动一个三方合并工具（例如TortoiseMerge），通常会显示三个版本：您的修改、服务器上的版本、以及原始共同版本。
  4. 您需要在合并工具中手动选择保留哪些修改，或者手动编辑文件，消除冲突。
  5. 保存合并后的文件。
  6. 在冲突文件上右键点击，选择“TortoiseSVN” -> “Resolved”。这会告诉SVN您已手动解决了冲突。
  7. 最后，提交您解决冲突后的文件。

命令行冲突解决：

  1. 执行svn update，如果发生冲突，会提示类似“C filename.ext”字样。冲突文件会生成多个临时文件：
    • filename.ext.mine：您的修改。
    • filename.ext.rOLD_REV：冲突发生前，您工作副本的基准版本（服务器上的旧版本）。
    • filename.ext.rNEW_REV：服务器上的最新版本。
    • filename.ext：包含冲突标记（<<<<<<<，=======，>>>>>>>）的合并结果。
  2. 手动编辑filename.ext，删除冲突标记，并保留您最终想要的代码。
  3. 告知SVN冲突已解决： 
    svn resolve --accept working <冲突文件路径>

    或者使用外部合并工具：

    svn mergetool <冲突文件路径>
  4. 提交解决冲突后的文件： 
    svn commit -m "解决 <文件名> 上的冲突"

四、SVN分支与合并策略

分支（Branching）和合并（Merging）是SVN实现复杂项目开发、版本发布和功能迭代的核心机制。

策略：为什么需要分支和合并？

在团队开发中，主干（trunk）通常用于存放最稳定、最新的代码。当需要开发一个新功能、修复一个紧急bug或准备发布一个版本时，直接在主干上操作可能会影响其他成员的工作，或导致主干代码不稳定。这时，就需要创建分支。

  • 功能开发： 为每个大功能创建一个独立的分支，团队成员可以在分支上并行开发，不影响主干。
  • Bug修复： 从发布的稳定版本创建修复分支，修复完成后合并回主干和发布分支。
  • 版本发布： 在发布前从主干创建发布分支（通常称为tags），冻结代码，进行测试和打包。

创建分支：如何创建（Branch）一个新分支？

在SVN中，分支和标签（Tag）本质上都是版本库中某个特定路径的拷贝。

TortoiseSVN操作：

  1. 在您想要创建分支的源代码（通常是trunk目录）上右键点击。
  2. 选择“TortoiseSVN” -> “Branch/tag…”。
  3. 在“To path”中，将路径修改为新分支的路径，例如/branches/my_new_feature。
  4. 在“Create copy in the repository from”中，选择基于哪个版本创建（通常是HEAD revision，即最新版本）。
  5. 填写“Log message”，点击“OK”。

命令行操作：

svn copy <源URL> <目标URL> -m "您的提交信息"

例如，从主干创建新功能分支： 

svn copy https://your-server-ip/svn/MyProject/trunk \
         https://your-server-ip/svn/MyProject/branches/feature_A \
         -m "Create branch for feature A"

创建标签（通常用于发布版本，后续不再修改）： 

svn copy https://your-server-ip/svn/MyProject/trunk \
         https://your-server-ip/svn/MyProject/tags/release_1.0.0 \
         -m "Tag release 1.0.0"

分支管理：如何切换（Switch）工作副本到不同分支？

您可以在同一个工作副本中快速切换到不同的分支进行工作。

TortoiseSVN操作：

  1. 在您的工作副本根目录上右键点击。
  2. 选择“TortoiseSVN” -> “Switch…”。
  3. 在“To URL”中，输入您要切换到的分支URL（例如https://your-server-ip/svn/MyProject/branches/feature_A）。
  4. 点击“OK”。SVN会下载新分支的代码并更新您的工作副本。

命令行操作：

svn switch <目标分支URL>

例如，切换到feature_A分支： 

svn switch https://your-server-ip/svn/MyProject/branches/feature_A

切换到主干： 

svn switch https://your-server-ip/svn/MyProject/trunk

整合代码：如何合并（Merge）分支到主干或其他分支？

当分支上的开发工作完成并测试稳定后，需要将其合并回主干或其他目标分支。

TortoiseSVN操作：

  1. 首先，确保您的目标合并目录（例如trunk的工作副本）是最新状态：对其执行“SVN Update”。
  2. 在目标合并目录上右键点击，选择“TortoiseSVN” -> “Merge…”。
  3. 在合并向导中，通常选择“Merge a range of revisions”（合并指定版本范围的差异）。
  4. 在“URL to merge from”中输入源分支的URL（例如https://your-server-ip/svn/MyProject/branches/feature_A）。
  5. 在“Revision range to merge”中选择要合并的版本范围。
    • 如果您是第一次将该分支合并到主干，通常选择“All revisions”（即从分支创建时到当前分支最新版本的所有改动）。TortoiseSVN会自动追踪合并历史，避免重复合并。
    • 如果之前合并过一部分，只选择尚未合并的版本范围。
  6. 勾选“Record only the merge, not the actual changes”（只记录合并操作，不实际改变文件，用于后续反向合并或特殊情况，通常不勾选）。
  7. 点击“Test Merge”（测试合并）进行预检，查看是否有冲突。
  8. 点击“Merge”（执行合并）。
  9. 合并完成后，您需要解决可能出现的冲突（如上文所述）。
  10. 最后，提交您合并后的工作副本到服务器。

命令行操作：

  1. 进入您的目标合并目录（例如trunk的工作副本），并确保它是最新状态： 
    cd MyProject/trunk
svn update
  2. 执行合并命令： 
    svn merge <源分支URL> .

    例如，将feature_A合并到当前主干：

    svn merge https://your-server-ip/svn/MyProject/branches/feature_A .

    （SVN会自动追踪合并信息，智能合并。若要指定版本范围，使用-r参数，例如 svn merge -r 100:200 <源分支URL> .）

  3. 解决可能出现的冲突。
  4. 提交合并后的代码： 
    svn commit -m "Merge feature_A branch into trunk"

合并的黄金法则：

  • 在合并前，务必更新目标合并路径到最新版本。
  • 合并后，仔细检查合并结果，并解决所有冲突。
  • 合并成功后，立即提交。
  • 遵循“feature branch -> trunk -> release tag”的合并流程，保持主干的稳定性和清晰性。

五、SVN实用辅助功能

文件过滤：如何使用忽略列表（Ignore List）？

在项目中，有些文件或目录是不需要纳入版本控制的，例如编译生成的临时文件（.obj, .exe）、日志文件（.log）、IDE配置文件（.iml, .vs）、第三方库文件等。SVN的忽略列表可以帮助您实现这一点。

TortoiseSVN操作：

  1. 在您想要忽略的文件或文件夹上右键点击。
  2. 选择“TortoiseSVN” -> “Add to ignore list”。
  3. 您可以选择忽略单个文件，或忽略所有匹配特定模式的文件（例如*.obj）。
  4. TortoiseSVN会在父目录上设置一个名为svn:ignore的属性。这个属性本身是需要提交到版本库的。

命令行操作：

  1. 进入您想设置忽略列表的目录。
  2. 使用svn propset命令设置svn:ignore属性： 
    svn propset svn:ignore "temp.log
*.obj
build/" .

    （注意：每一行是一个忽略模式，空行会被忽略，最后那个点表示当前目录。如果属性值包含多行，需要逐行写入或使用外部文件导入。）

    例如，从文件导入忽略规则：

    svn propset svn:ignore -F .svnignore .

    其中.svnignore文件内容：

    # .svnignore
*.log
*.tmp
build/
config.local.php
.idea/
  3. 提交该目录的属性变更： 
    svn commit -m "Add svn:ignore property to exclude build files"

查看已设置的忽略规则： 

svn propget svn:ignore .

属性管理：如何设置SVN属性？

除了svn:ignore，SVN还支持设置其他内置或自定义属性，来为文件或目录附加元数据。例如：

  • svn:keywords：当文件被检出时，某些关键词（如$Date$, $Revision$）会被自动替换为相应的值。
  • svn:executable：在Unix/Linux系统上，为文件添加可执行权限。
  • svn:mime-type：设置文件的MIME类型，有助于客户端正确处理文件。

TortoiseSVN操作：

  1. 在文件或目录上右键点击。
  2. 选择“TortoiseSVN” -> “Properties”。
  3. 在弹出的对话框中，您可以添加、编辑或删除属性。

命令行操作：

svn propset <属性名> <属性值> <文件或目录路径> # 设置属性
svn propget <属性名> <文件或目录路径> # 获取属性
svn propdel <属性名> <文件或目录路径> # 删除属性

例如，设置index.html文件的关键词替换： 

svn propset svn:keywords "Id Date Revision" index.html
svn commit -m "Enable keyword substitution for index.html"

然后，在index.html文件中写入$Id$ $Date$ $Revision$，当文件被检出或更新时，这些占位符就会被SVN自动替换为实际的值。

结语

SVN作为一款成熟稳定的集中式版本控制系统，以其直观易用的特性，在众多项目和团队中发挥着重要作用。掌握SVN的使用，无论是服务器的搭建、客户端的基础操作，还是进阶的冲突解决、分支合并策略，都能显著提升您的团队协作效率和项目管理水平。希望这篇指南能帮助您更好地理解和运用SVN，让您的代码管理之路更加顺畅高效。

svn怎么使用