Mac 搭建 SVN 环境及使用方法 – wiki基地

Mac 搭建 SVN 环境及使用方法详解

摘要: 本文将详细介绍在 macOS 操作系统上搭建 Subversion (SVN) 版本控制系统的服务器环境，并阐述如何在 Mac 上使用 SVN 客户端进行代码或文档的版本管理。内容涵盖 SVN 的基本概念、多种安装方式、服务器配置（包括 svnserve 和 Apache + mod_dav_svn 两种模式）、用户与权限管理、客户端的基本操作以及常见问题与最佳实践，旨在为 Mac 用户提供一份全面、细致的 SVN 环境搭建与使用指南。

关键词: Mac, macOS, SVN, Subversion, 版本控制, svnserve, Apache, mod_dav_svn, Homebrew, 客户端, 搭建, 配置, 使用

1. 引言

1.1 什么是 SVN (Subversion)？

Subversion（简称 SVN）是一个开源的版本控制系统（Version Control System, VCS）。它旨在替代旧的 CVS（Concurrent Versions System），用于管理随时间改变的数据。这些数据通常是源代码文件，但 SVN 实际上可以管理任何类型的文件集合，如文档、图片等。SVN 允许多个用户协同工作在同一项目上，记录每次修改的历史，并能在需要时恢复到之前的版本。

1.2 为什么选择 SVN？

尽管现在 Git 是更为主流的分布式版本控制系统，但在某些特定场景下，SVN 仍然具有其优势：

集中式管理: SVN 采用集中式模型，所有版本历史存储在单一的中央服务器上。这使得权限管理和审计更为直观和集中。
易于理解: 对于初学者或习惯了集中式工作流的团队，SVN 的概念（如检出、更新、提交）相对更容易理解和上手。
对大型二进制文件友好: 相较于 Git，SVN 在处理大型二进制文件或超大代码库时，其检出和更新操作可能表现更优，因为它默认只检出最新版本，且不需在本地存储完整的历史副本。
目录版本控制: SVN 可以对目录进行版本控制，包括目录的添加、删除、重命名等操作，这在某些项目中很有用。
细粒度权限控制: SVN 通过路径授权（Path-Based Authorization）可以非常方便地对仓库内不同目录设置不同的读写权限。

1.3 在 Mac 上使用 SVN 的场景

Mac 用户，无论是开发者、设计师还是文档编写者，都可能需要在本地或团队内部署 SVN 环境：

个人项目管理: 在本地搭建 SVN 服务器管理个人代码、设计稿或重要文档的版本。
小型团队协作: 为小型开发或设计团队提供一个简单、易用的版本控制解决方案。
与现有 SVN 系统对接: 如果公司或项目组仍在使用 SVN，Mac 用户需要配置 SVN 客户端与之交互。
学习与测试: 用于学习版本控制概念或测试 SVN 相关功能。

2. 在 Mac 上安装 SVN

macOS 通常不会预装完整的 SVN 工具链（尤其是服务器部分），但可以通过多种方式安装。

2.1 使用 Homebrew (推荐)

Homebrew 是 macOS 上最流行的包管理器，安装 SVN 非常方便。

安装 Homebrew (如果尚未安装):
打开“终端” (Terminal.app)，执行以下命令：
bash /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按照提示完成安装过程，可能需要输入管理员密码。安装完成后，根据提示将 Homebrew 添加到 PATH。
更新 Homebrew:
bash brew update
安装 SVN:
bash brew install subversion
Homebrew 会自动处理依赖关系并安装最新稳定版的 Subversion。安装完成后，它通常会包含 svn, svnadmin, svnserve, svnsync 等命令行工具，以及 Apache 的 mod_dav_svn 模块（如果依赖 Apache 的话）。
验证安装:
在终端输入以下命令查看 SVN 版本：
bash svn --version
如果能看到版本信息，则表示安装成功。同时可以检查 svnserve 和 svnadmin：
bash svnserve --version svnadmin --version

2.2 使用 Xcode Command Line Tools

较旧版本的 macOS 可能通过安装 Xcode 或其 Command Line Tools 附带了 SVN 客户端。但这个版本可能较旧，并且通常不包含 svnserve 服务器程序。

检查是否已安装:
尝试在终端运行 svn --version。如果命令存在，则说明已安装。
安装 Command Line Tools:
如果未安装，可以通过以下命令安装：
bash xcode-select --install
这会弹出安装窗口，按照提示操作即可。安装完成后再次检查 svn --version。

注意: 强烈推荐使用 Homebrew 安装，因为它能提供最新版本，并且包含了服务器组件和 Apache 模块，管理起来也更方便。

3. 搭建 SVN 服务器

搭建 SVN 服务器主要有两种方式：使用内置的轻量级服务器 svnserve，或者将 SVN 集成到 Apache HTTP 服务器中（通过 mod_dav_svn 模块）。

3.1 使用 `svnserve` (独立服务器模式)

svnserve 模式配置简单，资源占用少，适合个人或小型内部团队使用，通过 svn:// 协议访问。

创建 SVN 仓库根目录:
选择一个合适的位置存放所有 SVN 仓库。例如，在用户主目录下创建一个 svn_repos 目录：
bash mkdir ~/svn_repos
注意：实际生产环境建议放在更规范的位置，如 /usr/local/svn 或 /srv/svn，并设置好权限。
创建具体的 SVN 仓库:
使用 svnadmin create 命令创建一个新的仓库。例如，创建一个名为 myproject 的仓库：
bash svnadmin create ~/svn_repos/myproject
执行成功后，~/svn_repos/myproject 目录下会生成一系列文件和子目录，这就是仓库的结构。
配置仓库访问控制 (~/svn_repos/myproject/conf/):
进入仓库的 conf 目录，主要配置以下三个文件：
- svnserve.conf (服务器主配置文件):
  编辑此文件 (vim ~/svn_repos/myproject/conf/svnserve.conf)，去掉相关行的注释符 # 并修改配置。关键配置项：
  ini [general] # 匿名用户不可读 (需要认证) anon-access = none # 认证用户可读写 auth-access = write # 指定密码数据库文件路径 (相对于 conf 目录) password-db = passwd # 指定权限配置文件路径 (相对于 conf 目录) authz-db = authz # 认证领域，会在客户端提示时显示，区分不同仓库 realm = My Project Repository
  重要提示：确保行首没有多余的空格，否则可能导致配置不生效。
- passwd (用户密码文件):
  编辑此文件 (vim ~/svn_repos/myproject/conf/passwd)，添加用户和密码。格式为 username = password。
  ini [users] # 格式: 用户名 = 密码 user1 = pass1 user2 = secretpassword admin = complex_pwd_123
- authz (权限控制文件):
  编辑此文件 (vim ~/svn_repos/myproject/conf/authz)，定义用户组和路径权限。
  “`ini
  [groups]
  # 定义用户组
  admins = admin
  developers = user1, user2
  readers = guest # 如果允许匿名读，可以加个 guest 用户
  
  根目录权限设置 (仓库名:/)
  
  [myproject:/]
  
  管理员组有读写权限
  
  @admins = rw
  
  开发者组有读写权限
  
  @developers = rw
  
  其他所有用户无权限 (如果 anon-access=none, 这行可以省略或设为 r)
  - =
  特定目录权限 (例如，只读的文档目录)
  
  [myproject:/docs]
  
  所有认证用户可读 (假设 auth-access = write)
  
  或者可以指定特定组/用户
  
  @developers = r
  @admins = rw
  * = r # 如果希望认证用户默认可读
  
  敏感目录权限
  
  [myproject:/private]
  
  只有管理员可访问
  
  @admins = rw
  * =
  `` *说明:* *[groups]段定义用户组。 *[<仓库名>:/<路径>]定义特定路径的权限。/代表仓库根目录。 *@<组名> = <权限>设置组权限。 *<用户名> = <权限>设置用户权限。 ** = <权限>设置所有其他用户的权限。 * 权限可以是r(只读),rw` (读写), 或空 (无权限)。
启动 svnserve 服务器:
在终端执行以下命令启动服务器：
bash svnserve -d -r ~/svn_repos
- -d: 以守护进程（后台）模式运行。
- -r ~/svn_repos: 指定仓库的根目录。客户端访问时，URL 中的路径是相对于这个根目录的。例如，访问 myproject 仓库的 URL 是 svn://<服务器IP或主机名>/myproject。
检查服务器状态:
可以使用 ps aux | grep svnserve 查看进程是否存在，或尝试用 SVN 客户端连接。
设置开机自启动 (可选但推荐):
为了让 svnserve 在 Mac 重启后自动运行，可以使用 macOS 的 launchd 服务。
- 创建一个 .plist 文件，例如 ~/Library/LaunchAgents/org.tigris.subversion.svnserve.plist (为当前用户启动) 或 /Library/LaunchDaemons/org.tigris.subversion.svnserve.plist (系统级别启动，需要 root 权限)。
- 文件内容示例 (~/Library/LaunchAgents/org.tigris.subversion.svnserve.plist):
  xml <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>org.tigris.subversion.svnserve</string> <key>ProgramArguments</key> <array>  <string>/opt/homebrew/bin/svnserve</string> <string>-d</string> <string>--foreground</string>  <string>-r</string>  <string>/Users/your_username/svn_repos</string>  </array> <key>RunAtLoad</key> <true/> <key>KeepAlive</key> <true/>    <key>StandardOutPath</key> <string>/Users/your_username/Library/Logs/svnserve.log</string> <key>StandardErrorPath</key> <string>/Users/your_username/Library/Logs/svnserve.error.log</string> </dict> </plist>
  将 your_username 替换为你的实际用户名，并确保 /opt/homebrew/bin/svnserve 是正确的路径 (可以通过 which svnserve 查看)。
- 加载服务:
  - 如果放在 ~/Library/LaunchAgents：
    bash launchctl load ~/Library/LaunchAgents/org.tigris.subversion.svnserve.plist
  - 如果放在 /Library/LaunchDaemons (需要 sudo)：
    bash sudo launchctl load /Library/LaunchDaemons/org.tigris.subversion.svnserve.plist
- 停止服务:
  bash launchctl unload <plist文件路径>
  或者 (对于系统服务)：
  bash sudo launchctl unload <plist文件路径>

3.2 使用 Apache + `mod_dav_svn` (HTTP/HTTPS 模式)

这种方式将 SVN 集成到 Apache Web 服务器中，通过 HTTP 或 HTTPS 协议访问 (http:// 或 https://)。优点是可以使用 Apache 的强大功能（如 SSL 加密、更灵活的认证机制），且能穿透防火墙。

确保 Apache 和 mod_dav_svn 已安装:
- macOS 通常自带 Apache，可以通过 sudo apachectl start 启动，并通过 http://localhost 访问测试。
- 如果使用 Homebrew 安装 SVN，通常 mod_dav_svn.so 模块文件会被安装。你需要找到它的位置，例如 /opt/homebrew/lib/httpd/modules/mod_dav_svn.so。
配置 Apache:
编辑 Apache 的主配置文件 httpd.conf。路径通常是 /etc/apache2/httpd.conf (系统自带) 或 /opt/homebrew/etc/httpd/httpd.conf (Homebrew 安装)。
- 加载模块: 确保以下两行没有被注释掉（去掉行首的 #），并指向正确的模块文件路径：
  apache LoadModule dav_module libexec/apache2/mod_dav.so LoadModule dav_svn_module /opt/homebrew/lib/httpd/modules/mod_dav_svn.so # 如果需要权限控制，可能还需要加载 LoadModule authz_svn_module /opt/homebrew/lib/httpd/modules/mod_authz_svn.so
  注意：模块路径可能因 Apache 版本和安装方式而异。
- 配置 SVN 仓库位置:
  在 httpd.conf 文件末尾或相关的虚拟主机配置文件中添加 <Location> 块来指定 SVN 服务的 URL 路径和仓库位置。
  “`apache
  
  # 启用 DAV
  DAV svn
  # 指定所有仓库的父目录 (推荐)
  SVNParentPath /Users/your_username/svn_repos
  # 或者，只暴露单个仓库
  # SVNPath /Users/your_username/svn_repos/myproject
```
# --- 访问控制 ---

# 启用基本认证
AuthType Basic
# 认证提示信息
AuthName "Subversion Repository"
# 指定 Apache 密码文件路径 (需要另外创建)
AuthUserFile /Users/your_username/svn_auth/svn-passwd
# 指定 SVN 权限文件路径 (可以使用与 svnserve 相同的 authz 文件)
AuthzSVNAccessFile /Users/your_username/svn_repos/authz.conf
# 要求用户必须通过认证才能访问
Require valid-user
```
  `` *说明:* */svn是你希望通过 Web 访问 SVN 的路径，例如http://localhost/svn/myproject。 *SVNParentPath指定包含多个仓库的目录。Apache 会自动识别其中的仓库。 *SVNPath指定单个仓库的路径。 *AuthType Basic使用 HTTP 基本认证。 *AuthUserFile指向一个使用htpasswd命令创建的文件。 *AuthzSVNAccessFile指向 SVN 的权限配置文件。可以创建一个全局的authz.conf放在svn_repos目录下，或者继续使用每个仓库内的authz文件（但路径要写对）。**推荐使用全局authz文件，并在其中使用[仓库名:/路径]格式进行配置。** *Require valid-user表示任何通过密码文件验证的合法用户都可以访问（具体权限由AuthzSVNAccessFile` 控制）。
创建 Apache 密码文件 (htpasswd):
使用 htpasswd 命令创建和管理密码文件。
- 创建文件并添加第一个用户:
  bash # -c 表示创建新文件 htpasswd -c /Users/your_username/svn_auth/svn-passwd user1 # 会提示输入并确认密码
  确保 /Users/your_username/svn_auth/ 目录存在。
- 添加后续用户 (不使用 -c):
  bash htpasswd /Users/your_username/svn_auth/svn-passwd user2 htpasswd /Users/your_username/svn_auth/svn-passwd admin
创建或配置全局 authz 文件 (如果使用 AuthzSVNAccessFile):
如果决定使用全局 authz 文件（例如 /Users/your_username/svn_repos/authz.conf），其格式与仓库内部的 authz 文件类似，但需要在路径前加上仓库名：
“`ini
[groups]
admins = admin
developers = user1, user2

[myproject:/]
@admins = rw
@developers = rw
* = r # 或 * =

[another_project:/]
@admins = rw
* =

[myproject:/docs]
@developers = r
* = r
“`
检查 Apache 配置并重启:
- 检查配置文件语法：
  bash # 系统自带 Apache sudo apachectl configtest # Homebrew Apache brew services httpd configtest # 或者直接用 apachectl 路径 /opt/homebrew/bin/apachectl configtest
- 如果语法正确 (Syntax OK)，重启 Apache 服务：
  bash # 系统自带 Apache sudo apachectl restart # Homebrew Apache brew services restart httpd
访问测试:
打开浏览器或使用 SVN 客户端访问 http://localhost/svn/myproject (或你配置的 URL)。应该会弹出认证对话框，输入 htpasswd 文件中设置的用户名和密码。

HTTPS 配置: 为了安全，强烈建议为 Apache 配置 SSL/TLS，使用 HTTPS 访问 SVN。这涉及到获取 SSL 证书（可以使用 Let’s Encrypt 或自签名证书）并修改 Apache 的 SSL 配置。这部分内容超出了 SVN 本身的配置，但对于生产环境至关重要。

4. Mac 上使用 SVN 客户端

无论是在本地还是连接远程 SVN 服务器，Mac 用户主要通过命令行或图形界面 (GUI) 客户端与 SVN 交互。

4.1 命令行客户端 (`svn`)

这是最基础也是最强大的方式。以下是一些常用命令：

检出 (Checkout): 从服务器获取一个工作副本 (Working Copy)。
“`bash
# svn:// 协议 (svnserve)
svn checkout svn://<服务器IP或主机名>/<仓库名>/<路径> <本地目标目录>
# 示例: 检出 myproject 仓库到本地 myproject_wc 目录
svn checkout svn://localhost/myproject ~/myproject_wc
# 如果仓库根目录就是 -r 指定的目录，并且只有一个仓库，可以省略仓库名
# svn checkout svn://localhost/ ~/myproject_wc

http:// 或 https:// 协议 (Apache)

svn checkout http://<服务器IP或主机名>/svn/<仓库名>/<路径> <本地目标目录>

示例:

svn checkout http://localhost/svn/myproject ~/myproject_wc –username user1

会提示输入密码

`` *<路径>: 可选，如果只想检出仓库的某个子目录。 *<本地目标目录>: 可选，如果省略，会在当前目录下创建与仓库名或路径末尾部分同名的目录。 *–username`: 可选，指定用户名，否则会提示输入。SVN 会缓存认证信息。
更新 (Update): 将服务器上的最新更改合并到本地工作副本。进入工作副本目录后执行：
bash cd ~/myproject_wc svn update
会显示更新的文件状态 (A=添加, D=删除, U=更新, C=冲突, G=合并)。
查看状态 (Status): 查看本地工作副本相对于仓库的修改状态。
bash svn status
常用状态码：
- M: Modified (文件已修改)
- A: Added (文件已计划添加)
- D: Deleted (文件已计划删除)
- ?: Not versioned (文件未纳入版本控制)
- !: Missing (文件丢失，可能被手动删除)
- C: Conflicted (文件在更新或合并时发生冲突)
- ~: Obstructed (同名但类型不同的项存在)
添加 (Add): 将新文件或目录加入版本控制。
bash # 添加单个文件 svn add new_file.txt # 添加整个目录及其内容 (递归) svn add new_directory
添加后，文件状态变为 A，需要通过 svn commit 提交到仓库。
删除 (Delete): 从版本控制中删除文件或目录。
bash svn delete old_file.txt svn delete old_directory
删除后，文件状态变为 D，需要通过 svn commit 提交到仓库。这只是标记删除，历史记录仍然存在。
移动/重命名 (Move/Rename): 在版本库内移动或重命名文件/目录（保留历史）。
bash svn move source_file.txt destination_file.txt svn move old_dir new_dir
相当于 svn copy + svn delete，状态会显示为 D 和 A (带 + 号)。
复制 (Copy): 在版本库内复制文件/目录（常用于创建分支或标签）。
bash # 复制文件 svn copy file.txt file_copy.txt # 创建分支 (将 trunk 复制到 branches/new_feature) svn copy svn://localhost/myproject/trunk svn://localhost/myproject/branches/new_feature -m "Create new feature branch" # 注意：分支创建通常是直接在服务器上操作 URL
提交 (Commit): 将本地工作副本的修改（Add, Delete, Modify, Move）发送到服务器仓库。
bash # 提交所有修改，并添加说明信息 svn commit -m "Implemented feature X and fixed bug Y" # 只提交特定文件 svn commit file1.txt file2.txt -m "Updated specific files"
- -m "...": 提供本次提交的日志信息，非常重要！
查看日志 (Log): 查看提交历史记录。
bash # 查看当前目录及子目录的日志 svn log # 查看特定文件的日志 svn log path/to/file.txt # 显示更详细信息 (包括修改的文件列表) svn log -v # 限制显示最近 N 条日志 svn log -l 5
比较差异 (Diff): 查看文件修改的具体内容。
bash # 查看工作副本相对于基线版本 (上次更新/检出) 的修改 svn diff # 查看特定文件的修改 svn diff path/to/file.txt # 查看两个版本之间的差异 svn diff -r <版本号1>:<版本号2> path/to/file.txt
撤销本地修改 (Revert): 丢弃对工作副本文件的本地修改，恢复到上次更新或检出的状态。
bash # 撤销对单个文件的修改 svn revert path/to/modified_file.txt # 递归撤销目录下所有修改 svn revert -R .
警告：此操作不可逆，会丢失本地未提交的修改。
解决冲突 (Resolve): 当 svn update 遇到冲突 (状态 C) 时，SVN 会在工作副本中生成几个文件（.mine, .rOLDREV, .rNEWREV）。你需要手动编辑冲突文件，解决差异，然后告诉 SVN 冲突已解决：
bash # 手动编辑 file_with_conflict.txt, 解决 <<<<<<<, =======, >>>>>>> 标记的内容 # ... 编辑完成 ... # 标记冲突已解决 svn resolved path/to/file_with_conflict.txt # 然后可以提交 svn commit -m "Resolved conflict in file_with_conflict.txt"
清理 (Cleanup): 如果上次 SVN 操作（如更新、提交）被中断，工作副本可能处于锁定状态。运行 svn cleanup 可以解除锁定并清理临时文件。
bash svn cleanup

4.2 图形界面 (GUI) 客户端

对于不喜欢命令行的用户，Mac 上有许多优秀的 SVN GUI 客户端：

Cornerstone: 功能强大且界面美观的商业 SVN 客户端，深受 Mac 用户喜爱。提供直观的比较、合并、日志查看和仓库浏览功能。
Versions: 另一款流行的商业 SVN 客户端，界面简洁，易于上手。
SmartSVN: 跨平台的 SVN 客户端（有免费版和专业版），功能全面，适合专业用户。
Xcode 集成: Xcode 内置了对 SVN 的支持，可以直接在 IDE 中进行检出、提交、更新、比较等操作（偏向于代码管理）。
SnailSVN (Finder 扩展): 提供类似 Windows TortoiseSVN 的体验，将 SVN 状态图标和右键菜单集成到 Finder 中。

使用 GUI 客户端通常更直观，尤其是在处理复杂的合并、分支切换和冲突解决时。只需按照界面提示操作即可，底层执行的仍然是 SVN 命令。

5. 常见问题与最佳实践

5.1 常见问题

连接失败:
- 检查服务器 IP/主机名和端口是否正确。
- svnserve: 确认 svnserve 进程正在运行 (ps aux | grep svnserve)，防火墙是否允许 SVN 端口（默认 3690）。
- Apache: 确认 Apache 服务正在运行 (sudo apachectl status 或 brew services list)，防火墙是否允许 HTTP/HTTPS 端口（80/443），Apache 配置是否正确。
认证失败:
- 检查用户名、密码是否正确。
- svnserve: 确认 passwd 文件格式正确，用户名存在。
- Apache: 确认 htpasswd 文件中的用户名和密码正确。
- 清除本地缓存的认证信息：rm -rf ~/.subversion/auth/svn.simple/* (小心操作，会要求重新输入所有密码)。
权限不足:
- 检查 authz 文件配置是否正确，路径、组名、用户名是否有误，权限（r/rw）是否分配得当。注意 [仓库名:/路径] 的格式。
- Apache: 确保 Apache 运行用户对仓库目录和配置文件有读取权限。
仓库锁定 (Working copy ... locked):
- 通常是上次操作中断导致。进入锁定的工作副本目录，运行 svn cleanup。
冲突 (Conflict discovered in ...):
- 这是正常现象，表示你本地的修改和服务器上的更新有重叠。按照 4.1.12 步骤手动解决冲突。

5.2 最佳实践

原子提交: 每次提交应该只包含一个逻辑上完整的更改（如一个功能、一个 Bug 修复）。
编写清晰的提交日志: 使用 -m 参数提供有意义的提交信息，说明“为什么”做这个修改，而不仅仅是“做了什么”。
先更新再提交 (svn update before svn commit): 减少冲突的可能性。
善用分支: 对于新功能开发、Bug 修复或实验性更改，创建分支 (svn copy)，完成后再合并 (svn merge)回主干 (trunk)。
忽略不需要版本控制的文件: 使用 svn:ignore 属性或全局忽略设置，避免提交编译生成的文件、临时文件、IDE 配置文件等。
bash # 查看当前目录的忽略属性 svn propget svn:ignore . # 设置忽略属性 (例如忽略所有 .log 文件和 build 目录) # 可以将忽略规则写入一个文件 ignore.txt，每行一个模式 # *.log # build/ svn propset svn:ignore -F ignore.txt . # 或者直接命令行设置 (用换行符分隔) svn propset svn:ignore "*.log'$'\n'build/" . # 提交属性更改 svn commit -m "Set ignore patterns for build artifacts and logs."
定期备份仓库: SVN 服务器上的仓库数据至关重要。定期使用 svnadmin hotcopy 或 svnadmin dump 备份仓库，并将备份文件存储在安全的位置。
使用 HTTPS: 如果通过 Apache 提供服务，务必配置 SSL/TLS，保证传输安全。

6. 总结

在 Mac 上搭建和使用 SVN 环境是一个相对直接的过程。通过 Homebrew 可以轻松安装所需的工具链。选择 svnserve 模式可以快速搭建一个轻量级的本地或内部服务器，配置简单直观。而集成 Apache 的 mod_dav_svn 模式则提供了更强大、更安全（尤其是配置 HTTPS 后）的解决方案，适合更广泛的应用场景。

无论是使用命令行客户端 svn 还是选择一款优秀的 GUI 工具，掌握 SVN 的基本工作流程——检出、更新、修改、查看状态、添加、删除、提交、解决冲突——是高效使用版本控制的关键。遵循最佳实践，如原子提交、清晰日志、善用分支和忽略无关文件，能显著提高个人和团队的工作效率与代码质量。

尽管 Git 在现代开发中占据主导地位，但 SVN 作为一个成熟、稳定且在特定场景下依然适用的版本控制系统，了解如何在 Mac 上配置和使用它仍然具有重要的价值。希望本文提供的详细步骤和说明能帮助 Mac 用户成功搭建并有效利用 SVN 环境。

Mac 搭建 SVN 环境及使用方法详解

1. 引言

1.1 什么是 SVN (Subversion)？

1.2 为什么选择 SVN？

1.3 在 Mac 上使用 SVN 的场景

2. 在 Mac 上安装 SVN

2.1 使用 Homebrew (推荐)

2.2 使用 Xcode Command Line Tools

3. 搭建 SVN 服务器

3.1 使用 svnserve (独立服务器模式)

根目录权限设置 (仓库名:/)

管理员组有读写权限

开发者组有读写权限

其他所有用户无权限 (如果 anon-access=none, 这行可以省略或设为 r)

特定目录权限 (例如，只读的文档目录)

所有认证用户可读 (假设 auth-access = write)

或者可以指定特定组/用户

敏感目录权限

只有管理员可访问

3.2 使用 Apache + mod_dav_svn (HTTP/HTTPS 模式)

4. Mac 上使用 SVN 客户端

4.1 命令行客户端 (svn)

http:// 或 https:// 协议 (Apache)

示例:

会提示输入密码