SVN提交脚本编写实战教程解决日常版本控制难题

威震华夏关云长

引言

Subversion（SVN）是一个广泛使用的版本控制系统，它帮助团队协作开发、追踪文件变更、管理项目历史。在日常开发工作中，频繁的SVN操作可能会变得繁琐且容易出错。通过编写SVN提交脚本，我们可以自动化这些重复性任务，减少人为错误，提高工作效率。本教程将带你深入了解SVN提交脚本的编写，解决日常版本控制中遇到的各种难题。

SVN基础知识回顾

在开始编写SVN提交脚本之前，让我们回顾一些SVN的基础知识：

SVN基本命令

• svn checkout：检出仓库中的代码到本地工作副本
• svn update：更新本地工作副本到最新版本
• svn add：添加新文件到版本控制
• svn delete：删除文件
• svn commit：提交更改到仓库
• svn status：查看工作副本的状态
• svn diff：查看文件差异
• svn log：查看提交历史
• svn merge：合并分支

工作副本状态

SVN工作副本中的文件可以有以下几种状态：

• 未版本控制（Unversioned）：新添加的文件，尚未纳入版本控制
• 正常（Normal）：文件未被修改
• 修改（Modified）：文件已被修改，但未提交
• 冲突（Conflicted）：文件在更新时发生冲突
• 删除（Deleted）：文件已被标记为删除，但未提交

常见SVN提交难题

在日常使用SVN的过程中，我们可能会遇到以下常见难题：

1. 忘记提交某些文件：在大型项目中，很容易遗漏一些修改过的文件。
2. 提交信息不规范：团队成员提交信息格式不统一，难以追踪和检索。
3. 代码冲突：多人协作时，代码合并冲突是常见问题。
4. 分支管理复杂：创建、合并分支时操作繁琐，容易出错。
5. 提交前忘记测试：直接提交未经测试的代码，可能导致构建失败。
6. 提交敏感信息：不小心将密码、密钥等敏感信息提交到仓库。

通过编写SVN提交脚本，我们可以有效解决这些问题。

SVN提交脚本的基础

SVN提交脚本通常使用Shell脚本（Linux/Mac）或批处理/PowerShell脚本（Windows）编写。下面是一些基础知识：

Shell脚本基础

Shell脚本是在Linux/Mac环境下常用的脚本语言。下面是一个简单的Shell脚本示例：

2. #!/bin/bash
4. # 这是一个注释
5. echo "Hello, SVN Script!"
7. # 变量定义
8. SVN_PATH="/usr/bin/svn"
9. WORKING_COPY="/path/to/working/copy"
11. # 执行SVN命令
12. $SVN_PATH update $WORKING_COPY

复制代码

Windows批处理基础

在Windows环境下，我们可以使用批处理或PowerShell脚本。下面是一个简单的批处理示例：

2. @echo off
3. REM 这是一个注释
4. echo Hello, SVN Script!
6. REM 变量定义
7. set SVN_PATH="C:\Program Files\Subversion\bin\svn.exe"
8. set WORKING_COPY="D:\path\to\working\copy"
10. REM 执行SVN命令
11. %SVN_PATH% update %WORKING_COPY%

复制代码

PowerShell基础

PowerShell是Windows环境下更强大的脚本语言，下面是一个简单的PowerShell示例：

2. # 这是一个注释
3. Write-Host "Hello, SVN Script!"
5. # 变量定义
6. $svnPath = "C:\Program Files\Subversion\bin\svn.exe"
7. $workingCopy = "D:\path\to\working\copy"
9. # 执行SVN命令
10. & $svnPath update $workingCopy

复制代码

实战案例：不同场景下的SVN提交脚本

简单提交脚本

让我们从最简单的提交脚本开始，这个脚本将执行基本的SVN提交操作。

Linux/Mac Shell脚本：

2. #!/bin/bash
4. # SVN提交脚本 - 基础版本
5. # 作者：Your Name
6. # 日期：YYYY-MM-DD
8. # 配置部分
9. SVN_CMD="/usr/bin/svn"
10. WORK_DIR="/path/to/your/working/copy"
11. LOG_MSG="Auto commit: $(date)"
13. # 检查工作目录是否存在
14. if [ ! -d "$WORK_DIR" ]; then
15.     echo "错误：工作目录 $WORK_DIR 不存在"
16.     exit 1
17. fi
19. # 进入工作目录
20. cd "$WORK_DIR" || exit 1
22. # 更新到最新版本
23. echo "正在更新工作副本..."
24. $SVN_CMD update
26. # 检查是否有修改
27. if [ -z "$($SVN_CMD status -q)" ]; then
28.     echo "没有检测到修改，无需提交"
29.     exit 0
30. fi
32. # 显示修改列表
33. echo "以下文件将被提交："
34. $SVN_CMD status
36. # 提交修改
37. echo "正在提交修改..."
38. $SVN_CMD commit -m "$LOG_MSG"
40. echo "提交完成"

复制代码

Windows批处理脚本：

2. @echo off
3. REM SVN提交脚本 - 基础版本
4. REM 作者：Your Name
5. REM 日期：YYYY-MM-DD
7. REM 配置部分
8. set SVN_CMD="C:\Program Files\Subversion\bin\svn.exe"
9. set WORK_DIR="D:\path\to\your\working\copy"
10. set LOG_MSG=Auto commit: %date% %time%
12. REM 检查工作目录是否存在
13. if not exist "%WORK_DIR%" (
14.     echo 错误：工作目录 %WORK_DIR% 不存在
15.     exit /b 1
16. )
18. REM 进入工作目录
19. cd /d "%WORK_DIR%" || exit /b 1
21. REM 更新到最新版本
22. echo 正在更新工作副本...
23. %SVN_CMD% update
25. REM 检查是否有修改
26. %SVN_CMD% status -q >nul
27. if errorlevel 1 (
28.     echo 没有检测到修改，无需提交
29.     exit /b 0
30. )
32. REM 显示修改列表
33. echo 以下文件将被提交：
34. %SVN_CMD% status
36. REM 提交修改
37. echo 正在提交修改...
38. %SVN_CMD% commit -m "%LOG_MSG%"
40. echo 提交完成

复制代码

Windows PowerShell脚本：

2. # SVN提交脚本 - 基础版本
3. # 作者：Your Name
4. # 日期：YYYY-MM-DD
6. # 配置部分
7. $svnCmd = "C:\Program Files\Subversion\bin\svn.exe"
8. $workDir = "D:\path\to\your\working\copy"
9. $logMsg = "Auto commit: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
11. # 检查工作目录是否存在
12. if (-not (Test-Path $workDir -PathType Container)) {
13.     Write-Error "错误：工作目录 $workDir 不存在"
14.     exit 1
15. }
17. # 进入工作目录
18. Set-Location $workDir
20. # 更新到最新版本
21. Write-Host "正在更新工作副本..."
22. & $svnCmd update
24. # 检查是否有修改
25. $statusOutput = & $svnCmd status -q
26. if ([string]::IsNullOrEmpty($statusOutput)) {
27.     Write-Host "没有检测到修改，无需提交"
28.     exit 0
29. }
31. # 显示修改列表
32. Write-Host "以下文件将被提交："
33. & $svnCmd status
35. # 提交修改
36. Write-Host "正在提交修改..."
37. & $svnCmd commit -m $logMsg
39. Write-Host "提交完成"

复制代码

带日志模板的提交脚本

规范化的提交日志对于团队协作非常重要。下面的脚本使用预定义的日志模板，确保提交信息的一致性。

Linux/Mac Shell脚本：

2. #!/bin/bash
4. # SVN提交脚本 - 带日志模板
5. # 作者：Your Name
6. # 日期：YYYY-MM-DD
8. # 配置部分
9. SVN_CMD="/usr/bin/svn"
10. WORK_DIR="/path/to/your/working/copy"
11. LOG_TEMPLATE="/path/to/log_template.txt"
12. TEMP_LOG="/tmp/svn_commit_log_$(date +%s).txt"
14. # 检查工作目录是否存在
15. if [ ! -d "$WORK_DIR" ]; then
16.     echo "错误：工作目录 $WORK_DIR 不存在"
17.     exit 1
18. fi
20. # 进入工作目录
21. cd "$WORK_DIR" || exit 1
23. # 更新到最新版本
24. echo "正在更新工作副本..."
25. $SVN_CMD update
27. # 检查是否有修改
28. if [ -z "$($SVN_CMD status -q)" ]; then
29.     echo "没有检测到修改，无需提交"
30.     exit 0
31. fi
33. # 显示修改列表
34. echo "以下文件将被提交："
35. $SVN_CMD status
37. # 复制日志模板到临时文件
38. if [ -f "$LOG_TEMPLATE" ]; then
39.     cp "$LOG_TEMPLATE" "$TEMP_LOG"
40. else
41.     echo "类型: [修复/功能/文档/重构/测试]" > "$TEMP_LOG"
42.     echo "范围: [核心/UI/数据库/API/配置]" >> "$TEMP_LOG"
43.     echo "问题描述:" >> "$TEMP_LOG"
44.     echo "" >> "$TEMP_LOG"
45.     echo "详细说明:" >> "$TEMP_LOG"
46.     echo "" >> "$TEMP_LOG"
47.     echo "测试方法:" >> "$TEMP_LOG"
48. fi
50. # 打开编辑器编辑日志
51. ${EDITOR:-vi} "$TEMP_LOG"
53. # 检查日志是否为空
54. if [ ! -s "$TEMP_LOG" ]; then
55.     echo "错误：提交日志不能为空"
56.     rm -f "$TEMP_LOG"
57.     exit 1
58. fi
60. # 提交修改
61. echo "正在提交修改..."
62. $SVN_CMD commit -F "$TEMP_LOG"
64. # 清理临时文件
65. rm -f "$TEMP_LOG"
67. echo "提交完成"

复制代码

Windows批处理脚本：

2. @echo off
3. REM SVN提交脚本 - 带日志模板
4. REM 作者：Your Name
5. REM 日期：YYYY-MM-DD
7. REM 配置部分
8. set SVN_CMD="C:\Program Files\Subversion\bin\svn.exe"
9. set WORK_DIR="D:\path\to\your\working\copy"
10. set LOG_TEMPLATE="D:\path\to\log_template.txt"
11. set TEMP_LOG="%TEMP%\svn_commit_log_%RANDOM%.txt"
13. REM 检查工作目录是否存在
14. if not exist "%WORK_DIR%" (
15.     echo 错误：工作目录 %WORK_DIR% 不存在
16.     exit /b 1
17. )
19. REM 进入工作目录
20. cd /d "%WORK_DIR%" || exit /b 1
22. REM 更新到最新版本
23. echo 正在更新工作副本...
24. %SVN_CMD% update
26. REM 检查是否有修改
27. %SVN_CMD% status -q >nul
28. if errorlevel 1 (
29.     echo 没有检测到修改，无需提交
30.     exit /b 0
31. )
33. REM 显示修改列表
34. echo 以下文件将被提交：
35. %SVN_CMD% status
37. REM 复制日志模板到临时文件
38. if exist "%LOG_TEMPLATE%" (
39.     copy "%LOG_TEMPLATE%" "%TEMP_LOG%" >nul
40. ) else (
41.     echo 类型: [修复/功能/文档/重构/测试] > "%TEMP_LOG%"
42.     echo 范围: [核心/UI/数据库/API/配置] >> "%TEMP_LOG%"
43.     echo 问题描述: >> "%TEMP_LOG%"
44.     echo. >> "%TEMP_LOG%"
45.     echo 详细说明: >> "%TEMP_LOG%"
46.     echo. >> "%TEMP_LOG%"
47.     echo 测试方法: >> "%TEMP_LOG%"
48. )
50. REM 打开记事本编辑日志
51. notepad "%TEMP_LOG%"
53. REM 检查日志是否为空
54. for %%F in ("%TEMP_LOG%") do set size=%%~zF
55. if %size% equ 0 (
56.     echo 错误：提交日志不能为空
57.     del "%TEMP_LOG%"
58.     exit /b 1
59. )
61. REM 提交修改
62. echo 正在提交修改...
63. %SVN_CMD% commit -F "%TEMP_LOG%"
65. REM 清理临时文件
66. del "%TEMP_LOG%"
68. echo 提交完成

复制代码

自动冲突解决的提交脚本

在多人协作的项目中，代码冲突是常见问题。下面的脚本可以自动检测和解决一些简单的冲突。

Linux/Mac Shell脚本：

2. #!/bin/bash
4. # SVN提交脚本 - 自动冲突解决
5. # 作者：Your Name
6. # 日期：YYYY-MM-DD
8. # 配置部分
9. SVN_CMD="/usr/bin/svn"
10. WORK_DIR="/path/to/your/working/copy"
11. LOG_MSG="Auto commit with conflict resolution: $(date)"
12. CONFLICT_RESOLVED=false
14. # 检查工作目录是否存在
15. if [ ! -d "$WORK_DIR" ]; then
16.     echo "错误：工作目录 $WORK_DIR 不存在"
17.     exit 1
18. fi
20. # 进入工作目录
21. cd "$WORK_DIR" || exit 1
23. # 更新到最新版本
24. echo "正在更新工作副本..."
25. $SVN_CMD update
27. # 检查是否有冲突
28. CONFLICTED_FILES=$($SVN_CMD status | grep "^C")
29. if [ -n "$CONFLICTED_FILES" ]; then
30.     echo "检测到冲突文件："
31.     echo "$CONFLICTED_FILES"
32.    
33.     # 尝试自动解决冲突
34.     for file in $(echo "$CONFLICTED_FILES" | awk '{print $2}'); do
35.         echo "正在尝试解决文件 $file 的冲突..."
36.         
37.         # 备份当前文件
38.         cp "$file" "$file.backup"
39.         
40.         # 尝试接受仓库版本
41.         $SVN_CMD resolve --accept working "$file"
42.         
43.         # 检查冲突是否已解决
44.         if ! $SVN_CMD status "$file" | grep -q "^C"; then
45.             echo "文件 $file 的冲突已自动解决"
46.             CONFLICT_RESOLVED=true
47.         else
48.             echo "无法自动解决文件 $file 的冲突，已恢复备份"
49.             mv "$file.backup" "$file"
50.         fi
51.     done
52.    
53.     # 如果有冲突被解决，显示差异
54.     if [ "$CONFLICT_RESOLVED" = true ]; then
55.         echo "冲突解决后的文件差异："
56.         for file in $(echo "$CONFLICTED_FILES" | awk '{print $2}'); do
57.             if [ -f "$file" ] && ! $SVN_CMD status "$file" | grep -q "^C"; then
58.                 $SVN_CMD diff "$file"
59.             fi
60.         done
61.     fi
62. fi
64. # 检查是否有修改
65. if [ -z "$($SVN_CMD status -q)" ]; then
66.     echo "没有检测到修改，无需提交"
67.     exit 0
68. fi
70. # 显示修改列表
71. echo "以下文件将被提交："
72. $SVN_CMD status
74. # 提交修改
75. echo "正在提交修改..."
76. $SVN_CMD commit -m "$LOG_MSG"
78. echo "提交完成"

复制代码

Windows PowerShell脚本：

2. # SVN提交脚本 - 自动冲突解决
3. # 作者：Your Name
4. # 日期：YYYY-MM-DD
6. # 配置部分
7. $svnCmd = "C:\Program Files\Subversion\bin\svn.exe"
8. $workDir = "D:\path\to\your\working\copy"
9. $logMsg = "Auto commit with conflict resolution: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
10. $conflictResolved = $false
12. # 检查工作目录是否存在
13. if (-not (Test-Path $workDir -PathType Container)) {
14.     Write-Error "错误：工作目录 $workDir 不存在"
15.     exit 1
16. }
18. # 进入工作目录
19. Set-Location $workDir
21. # 更新到最新版本
22. Write-Host "正在更新工作副本..."
23. & $svnCmd update
25. # 检查是否有冲突
26. $statusOutput = & $svnCmd status
27. $conflictedFiles = $statusOutput | Where-Object { $_ -match "^C" }
29. if ($conflictedFiles) {
30.     Write-Host "检测到冲突文件："
31.     $conflictedFiles
32.    
33.     # 尝试自动解决冲突
34.     foreach ($line in $conflictedFiles) {
35.         $file = $line -replace "^C\s+", ""
36.         Write-Host "正在尝试解决文件 $file 的冲突..."
37.         
38.         # 备份当前文件
39.         Copy-Item "$file" "$file.backup"
40.         
41.         # 尝试接受工作副本版本
42.         & $svnCmd resolve --accept working "$file"
43.         
44.         # 检查冲突是否已解决
45.         $newStatus = & $svnCmd status "$file"
46.         if ($newStatus -notmatch "^C") {
47.             Write-Host "文件 $file 的冲突已自动解决"
48.             $conflictResolved = $true
49.         }
50.         else {
51.             Write-Host "无法自动解决文件 $file 的冲突，已恢复备份"
52.             Move-Item "$file.backup" "$file" -Force
53.         }
54.     }
55.    
56.     # 如果有冲突被解决，显示差异
57.     if ($conflictResolved) {
58.         Write-Host "冲突解决后的文件差异："
59.         foreach ($line in $conflictedFiles) {
60.             $file = $line -replace "^C\s+", ""
61.             if (Test-Path $file -PathType Leaf) {
62.                 $newStatus = & $svnCmd status "$file"
63.                 if ($newStatus -notmatch "^C") {
64.                     & $svnCmd diff "$file"
65.                 }
66.             }
67.         }
68.     }
69. }
71. # 检查是否有修改
72. $statusOutput = & $svnCmd status -q
73. if ([string]::IsNullOrEmpty($statusOutput)) {
74.     Write-Host "没有检测到修改，无需提交"
75.     exit 0
76. }
78. # 显示修改列表
79. Write-Host "以下文件将被提交："
80. & $svnCmd status
82. # 提交修改
83. Write-Host "正在提交修改..."
84. & $svnCmd commit -m $logMsg
86. Write-Host "提交完成"

复制代码

分支管理脚本

分支管理是SVN中的重要功能，下面的脚本可以帮助简化分支的创建、切换和合并操作。

Linux/Mac Shell脚本：

2. #!/bin/bash
4. # SVN分支管理脚本
5. # 作者：Your Name
6. # 日期：YYYY-MM-DD
8. # 配置部分
9. SVN_CMD="/usr/bin/svn"
10. REPO_URL="https://svn.example.com/repo"
11. WORK_DIR="/path/to/your/working/copy"
12. BRANCHES_URL="$REPO_URL/branches"
13. TRUNK_URL="$REPO_URL/trunk"
15. # 显示帮助信息
16. show_help() {
17.     echo "SVN分支管理脚本"
18.     echo "用法: $0 [选项] [参数]"
19.     echo ""
20.     echo "选项:"
21.     echo "  create <分支名>     创建新分支"
22.     echo "  switch <分支名>     切换到指定分支"
23.     echo "  merge <分支名>      将指定分支合并到当前分支"
24.     echo "  list                列出所有分支"
25.     echo "  help                显示此帮助信息"
26.     echo ""
27.     echo "示例:"
28.     echo "  $0 create feature/new-feature"
29.     echo "  $0 switch feature/new-feature"
30.     echo "  $0 merge feature/new-feature"
31. }
33. # 创建分支
34. create_branch() {
35.     local branch_name=$1
36.     local branch_url="$BRANCHES_URL/$branch_name"
37.    
38.     echo "正在创建分支: $branch_name"
39.    
40.     # 检查分支是否已存在
41.     if $SVN_CMD ls "$BRANCHES_URL" | grep -q "^$branch_name/$"; then
42.         echo "错误：分支 $branch_name 已存在"
43.         exit 1
44.     fi
45.    
46.     # 创建分支
47.     $SVN_CMD copy -m "创建分支: $branch_name" "$TRUNK_URL" "$branch_url"
48.    
49.     echo "分支 $branch_name 创建成功"
50. }
52. # 切换分支
53. switch_branch() {
54.     local branch_name=$1
55.     local branch_url="$BRANCHES_URL/$branch_name"
56.    
57.     echo "正在切换到分支: $branch_name"
58.    
59.     # 检查工作目录是否存在
60.     if [ ! -d "$WORK_DIR" ]; then
61.         echo "错误：工作目录 $WORK_DIR 不存在"
62.         exit 1
63.     fi
64.    
65.     # 进入工作目录
66.     cd "$WORK_DIR" || exit 1
67.    
68.     # 检查分支是否存在
69.     if ! $SVN_CMD ls "$BRANCHES_URL" | grep -q "^$branch_name/$"; then
70.         echo "错误：分支 $branch_name 不存在"
71.         exit 1
72.     fi
73.    
74.     # 切换分支
75.     $SVN_CMD switch "$branch_url"
76.    
77.     echo "已切换到分支: $branch_name"
78. }
80. # 合并分支
81. merge_branch() {
82.     local branch_name=$1
83.     local branch_url="$BRANCHES_URL/$branch_name"
84.    
85.     echo "正在合并分支: $branch_name"
86.    
87.     # 检查工作目录是否存在
88.     if [ ! -d "$WORK_DIR" ]; then
89.         echo "错误：工作目录 $WORK_DIR 不存在"
90.         exit 1
91.     fi
92.    
93.     # 进入工作目录
94.     cd "$WORK_DIR" || exit 1
95.    
96.     # 检查分支是否存在
97.     if ! $SVN_CMD ls "$BRANCHES_URL" | grep -q "^$branch_name/$"; then
98.         echo "错误：分支 $branch_name 不存在"
99.         exit 1
100.     fi
101.    
102.     # 更新工作副本
103.     echo "正在更新工作副本..."
104.     $SVN_CMD update
105.    
106.     # 合并分支
107.     echo "正在合并分支 $branch_name 到当前分支..."
108.     $SVN_CMD merge --accept postpone "$branch_url" .
109.    
110.     # 检查是否有冲突
111.     if $SVN_CMD status | grep -q "^C"; then
112.         echo "警告：合并过程中发现冲突，请手动解决后提交"
113.         $SVN_CMD status | grep "^C"
114.     else
115.         echo "合并完成，无冲突"
116.         echo "请检查合并结果后提交"
117.     fi
118. }
120. # 列出分支
121. list_branches() {
122.     echo "可用分支:"
123.     $SVN_CMD ls "$BRANCHES_URL" | sed 's/\/$//'
124. }
126. # 主程序
127. main() {
128.     case "$1" in
129.         create)
130.             if [ -z "$2" ]; then
131.                 echo "错误：缺少分支名"
132.                 show_help
133.                 exit 1
134.             fi
135.             create_branch "$2"
136.             ;;
137.         switch)
138.             if [ -z "$2" ]; then
139.                 echo "错误：缺少分支名"
140.                 show_help
141.                 exit 1
142.             fi
143.             switch_branch "$2"
144.             ;;
145.         merge)
146.             if [ -z "$2" ]; then
147.                 echo "错误：缺少分支名"
148.                 show_help
149.                 exit 1
150.             fi
151.             merge_branch "$2"
152.             ;;
153.         list)
154.             list_branches
155.             ;;
156.         help|--help|-h)
157.             show_help
158.             ;;
159.         *)
160.             echo "错误：未知选项 $1"
161.             show_help
162.             exit 1
163.             ;;
164.     esac
165. }
167. # 执行主程序
168. main "$@"

复制代码

自动化测试集成提交脚本

在提交代码前运行自动化测试是一个好习惯，可以避免提交有问题的代码。下面的脚本集成了自动化测试功能。

Linux/Mac Shell脚本：

2. #!/bin/bash
4. # SVN提交脚本 - 集成自动化测试
5. # 作者：Your Name
6. # 日期：YYYY-MM-DD
8. # 配置部分
9. SVN_CMD="/usr/bin/svn"
10. WORK_DIR="/path/to/your/working/copy"
11. TEST_CMD="./run_tests.sh"  # 测试命令
12. LOG_MSG="Auto commit with tests: $(date)"
13. TEST_PASSED=false
15. # 检查工作目录是否存在
16. if [ ! -d "$WORK_DIR" ]; then
17.     echo "错误：工作目录 $WORK_DIR 不存在"
18.     exit 1
19. fi
21. # 进入工作目录
22. cd "$WORK_DIR" || exit 1
24. # 更新到最新版本
25. echo "正在更新工作副本..."
26. $SVN_CMD update
28. # 检查是否有修改
29. if [ -z "$($SVN_CMD status -q)" ]; then
30.     echo "没有检测到修改，无需提交"
31.     exit 0
32. fi
34. # 显示修改列表
35. echo "以下文件将被提交："
36. $SVN_CMD status
38. # 询问是否运行测试
39. read -p "是否在提交前运行测试？(y/n) " -n 1 -r
40. echo
41. if [[ $REPLY =~ ^[Yy]$ ]]; then
42.     echo "正在运行测试..."
43.    
44.     # 运行测试
45.     if [ -f "$TEST_CMD" ]; then
46.         chmod +x "$TEST_CMD"
47.         if $TEST_CMD; then
48.             echo "测试通过"
49.             TEST_PASSED=true
50.         else
51.             echo "错误：测试失败"
52.             read -p "是否仍要继续提交？(y/n) " -n 1 -r
53.             echo
54.             if [[ ! $REPLY =~ ^[Yy]$ ]]; then
55.                 echo "提交已取消"
56.                 exit 1
57.             fi
58.         fi
59.     else
60.         echo "警告：未找到测试脚本 $TEST_CMD，跳过测试"
61.     fi
62. fi
64. # 如果测试通过，添加测试通过的标记到提交信息
65. if [ "$TEST_PASSED" = true ]; then
66.     LOG_MSG="$LOG_MSG [TESTS PASSED]"
67. fi
69. # 提交修改
70. echo "正在提交修改..."
71. $SVN_CMD commit -m "$LOG_MSG"
73. echo "提交完成"

复制代码

Windows PowerShell脚本：

2. # SVN提交脚本 - 集成自动化测试
3. # 作者：Your Name
4. # 日期：YYYY-MM-DD
6. # 配置部分
7. $svnCmd = "C:\Program Files\Subversion\bin\svn.exe"
8. $workDir = "D:\path\to\your\working\copy"
9. $testCmd = ".\run_tests.ps1"  # 测试命令
10. $logMsg = "Auto commit with tests: $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')"
11. $testPassed = $false
13. # 检查工作目录是否存在
14. if (-not (Test-Path $workDir -PathType Container)) {
15.     Write-Error "错误：工作目录 $workDir 不存在"
16.     exit 1
17. }
19. # 进入工作目录
20. Set-Location $workDir
22. # 更新到最新版本
23. Write-Host "正在更新工作副本..."
24. & $svnCmd update
26. # 检查是否有修改
27. $statusOutput = & $svnCmd status -q
28. if ([string]::IsNullOrEmpty($statusOutput)) {
29.     Write-Host "没有检测到修改，无需提交"
30.     exit 0
31. }
33. # 显示修改列表
34. Write-Host "以下文件将被提交："
35. & $svnCmd status
37. # 询问是否运行测试
38. $runTests = Read-Host "是否在提交前运行测试？(y/n)"
39. if ($runTests -eq 'y' -or $runTests -eq 'Y') {
40.     Write-Host "正在运行测试..."
41.    
42.     # 运行测试
43.     if (Test-Path $testCmd -PathType Leaf) {
44.         try {
45.             & $testCmd
46.             if ($LASTEXITCODE -eq 0) {
47.                 Write-Host "测试通过"
48.                 $testPassed = $true
49.             } else {
50.                 Write-Error "错误：测试失败"
51.                 $continueCommit = Read-Host "是否仍要继续提交？(y/n)"
52.                 if ($continueCommit -ne 'y' -and $continueCommit -ne 'Y') {
53.                     Write-Host "提交已取消"
54.                     exit 1
55.                 }
56.             }
57.         } catch {
58.             Write-Error "运行测试时出错: $_"
59.             $continueCommit = Read-Host "是否仍要继续提交？(y/n)"
60.             if ($continueCommit -ne 'y' -and $continueCommit -ne 'Y') {
61.                 Write-Host "提交已取消"
62.                 exit 1
63.             }
64.         }
65.     } else {
66.         Write-Warning "未找到测试脚本 $testCmd，跳过测试"
67.     }
68. }
70. # 如果测试通过，添加测试通过的标记到提交信息
71. if ($testPassed) {
72.     $logMsg = "$logMsg [TESTS PASSED]"
73. }
75. # 提交修改
76. Write-Host "正在提交修改..."
77. & $svnCmd commit -m $logMsg
79. Write-Host "提交完成"

复制代码

高级技巧与最佳实践

1. 使用配置文件

将脚本的配置部分（如SVN路径、工作目录等）提取到单独的配置文件中，可以使脚本更加灵活，便于在不同环境中使用。

配置文件示例 (config.sh)：

2. #!/bin/bash
4. # SVN配置
5. SVN_CMD="/usr/bin/svn"
6. REPO_URL="https://svn.example.com/repo"
8. # 工作目录
9. WORK_DIR="/path/to/your/working/copy"
11. # 日志模板
12. LOG_TEMPLATE="/path/to/log_template.txt"
14. # 测试命令
15. TEST_CMD="./run_tests.sh"
17. # 邮件通知
18. EMAIL_NOTIFY="true"
19. EMAIL_RECIPIENTS="dev-team@example.com"

复制代码

脚本中加载配置文件：

2. #!/bin/bash
4. # 加载配置文件
5. SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
6. CONFIG_FILE="$SCRIPT_DIR/config.sh"
8. if [ -f "$CONFIG_FILE" ]; then
9.     source "$CONFIG_FILE"
10. else
11.     echo "错误：配置文件 $CONFIG_FILE 不存在"
12.     exit 1
13. fi
15. # 其余脚本内容...

复制代码

2. 日志记录

为脚本添加日志记录功能，可以方便地追踪脚本执行过程和排查问题。

日志函数示例：

2. #!/bin/bash
4. # 日志文件
5. LOG_FILE="/var/log/svn_script.log"
7. # 日志函数
8. log() {
9.     local level=$1
10.     local message=$2
11.     local timestamp=$(date "+%Y-%m-%d %H:%M:%S")
12.     echo "[$timestamp] [$level] $message" | tee -a "$LOG_FILE"
13. }
15. # 使用示例
16. log "INFO" "脚本开始执行"
17. log "ERROR" "工作目录不存在"
18. log "DEBUG" "SVN命令执行结果: $result"

复制代码

3. 错误处理

良好的错误处理可以使脚本更加健壮，避免因意外错误导致的问题。

错误处理示例：

2. #!/bin/bash
4. # 错误处理函数
5. handle_error() {
6.     local exit_code=$?
7.     local line_number=$1
8.     log "ERROR" "脚本在第 $line_number 行出错，退出码: $exit_code"
9.     exit $exit_code
10. }
12. # 设置错误处理陷阱
13. trap 'handle_error $LINENO' ERR
15. # 使用set -e使脚本在任何命令失败时立即退出
16. set -e
18. # 使用set -u使脚本在尝试使用未定义变量时报错
19. set -u
21. # 使用set -o pipefail使管道中的任何命令失败都会导致整个管道失败
22. set -o pipefail
24. # 其余脚本内容...

复制代码

4. 邮件通知

在脚本执行完成后发送邮件通知，可以让团队成员及时了解版本控制状态。

邮件通知函数示例：

2. #!/bin/bash
4. # 邮件通知函数
5. send_email() {
6.     local subject=$1
7.     local body=$2
8.     local recipients=$3
9.    
10.     echo "$body" | mail -s "$subject" "$recipients"
11. }
13. # 使用示例
14. send_email "SVN提交成功" "代码已成功提交到SVN仓库" "dev-team@example.com"

复制代码

5. 使用钩子脚本

SVN提供了钩子脚本功能，可以在特定事件发生时自动执行脚本。常见的钩子脚本包括：

• pre-commit：提交前执行，可用于验证提交内容
• post-commit：提交后执行，可用于发送通知或触发构建
• pre-revprop-change：修改修订版本属性前执行
• post-revprop-change：修改修订版本属性后执行

pre-commit钩子脚本示例：

2. #!/bin/bash
4. # SVN pre-commit钩子脚本
5. # 用于验证提交信息格式和检查敏感信息
7. REPOS="$1"
8. TXN="$2"
10. # 获取提交信息
11. SVNLOOK="/usr/bin/svnlook"
12. LOGMSG=$($SVNLOOK log -t "$TXN" "$REPOS")
14. # 验证提交信息不为空
15. if [ -z "$LOGMSG" ]; then
16.     echo "提交信息不能为空" >&2
17.     exit 1
18. fi
20. # 验证提交信息格式（以JIRA任务号开头）
21. if ! echo "$LOGMSG" | grep -qE "^[A-Z]+-[0-9]+:"; then
22.     echo "提交信息必须以JIRA任务号开头，例如：PROJ-123: 修复登录问题" >&2
23.     exit 1
24. fi
26. # 检查是否包含敏感信息
27. SENSITIVE_PATTERNS=("password" "secret" "key" "token")
28. CHANGED_FILES=$($SVNLOOK changed -t "$TXN" "$REPOS")
30. for file in $CHANGED_FILES; do
31.     if echo "$file" | grep -q "^[AU]"; then
32.         FILE_PATH=$(echo "$file" | awk '{print $2}')
33.         FILE_CONTENT=$($SVNLOOK cat -t "$TXN" "$REPOS" "$FILE_PATH")
34.         
35.         for pattern in "${SENSITIVE_PATTERNS[@]}"; do
36.             if echo "$FILE_CONTENT" | grep -i -q "$pattern"; then
37.                 echo "错误：文件 $FILE_PATH 可能包含敏感信息（$pattern）" >&2
38.                 exit 1
39.             fi
40.         done
41.     fi
42. done
44. # 所有检查通过，允许提交
45. exit 0

复制代码

常见问题与解决方案

1. SVN命令执行失败

问题：脚本中的SVN命令执行失败，但没有明确的错误信息。

解决方案：

• 添加详细的错误处理和日志记录
• 检查SVN命令的路径是否正确
• 确保工作目录存在且有正确的权限
• 使用svn --version检查SVN是否正确安装

2. #!/bin/bash
4. # 检查SVN是否安装
5. if ! command -v svn &> /dev/null; then
6.     echo "错误：SVN未安装或不在PATH中" >&2
7.     exit 1
8. fi
10. # 执行SVN命令并捕获输出和错误
11. result=$($SVN_CMD update 2>&1)
12. exit_code=$?
14. if [ $exit_code -ne 0 ]; then
15.     echo "SVN命令执行失败，退出码: $exit_code" >&2
16.     echo "错误信息: $result" >&2
17.     exit $exit_code
18. fi
20. echo "SVN命令执行成功: $result"

复制代码

2. 工作副本锁定

问题：脚本执行时遇到工作副本锁定问题。

解决方案：

• 检查是否有其他SVN进程正在运行
• 使用svn cleanup清理工作副本
• 添加重试机制，在锁定时自动重试

2. #!/bin/bash
4. # 带重试机制的SVN更新
5. MAX_RETRIES=3
6. RETRY_DELAY=5
8. retry_count=0
9. success=false
11. while [ $retry_count -lt $MAX_RETRIES ] && [ "$success" = false ]; do
12.     echo "尝试更新工作副本 (尝试 $((retry_count+1))/$MAX_RETRIES)..."
13.    
14.     if $SVN_CMD update; then
15.         success=true
16.         echo "工作副本更新成功"
17.     else
18.         retry_count=$((retry_count+1))
19.         if [ $retry_count -lt $MAX_RETRIES ]; then
20.             echo "更新失败，$RETRY_DELAY秒后重试..."
21.             sleep $RETRY_DELAY
22.             echo "执行清理操作..."
23.             $SVN_CMD cleanup
24.         else
25.             echo "错误：达到最大重试次数，更新失败" >&2
26.             exit 1
27.         fi
28.     fi
29. done

复制代码

3. 认证问题

问题：脚本执行时需要输入用户名和密码，无法自动化。

解决方案：

• 使用--username和--password参数提供凭据
• 使用SVN凭据缓存
• 使用SSH密钥认证（如果使用svn+ssh协议）

2. #!/bin/bash
4. # 使用凭据缓存的SVN命令
5. SVN_CMD="/usr/bin/svn --username your_username --password your_password --no-auth-cache"
7. # 或者使用凭据缓存
8. # 首次运行时手动认证，后续使用缓存
9. if [ ! -f "$HOME/.subversion/auth/svn.simple/*" ]; then
10.     echo "首次运行，请手动认证..."
11.     $SVN_CMD --username your_username info "$REPO_URL"
12. fi
14. # 后续命令可以使用缓存
15. $SVN_CMD update

复制代码

4. 路径问题

问题：脚本在不同环境下运行时，路径可能不同。

解决方案：

• 使用相对路径
• 从环境变量获取路径
• 自动检测路径

2. #!/bin/bash
4. # 自动检测SVN路径
5. if command -v svn &> /dev/null; then
6.     SVN_CMD="svn"
7. elif [ -f "/usr/bin/svn" ]; then
8.     SVN_CMD="/usr/bin/svn"
9. elif [ -f "/usr/local/bin/svn" ]; then
10.     SVN_CMD="/usr/local/bin/svn"
11. else
12.     echo "错误：无法找到SVN命令" >&2
13.     exit 1
14. fi
16. # 从环境变量获取工作目录，如果未设置则使用默认值
17. WORK_DIR="${WORK_DIR:-$(pwd)}"
19. # 检查工作目录是否存在
20. if [ ! -d "$WORK_DIR" ]; then
21.     echo "错误：工作目录 $WORK_DIR 不存在" >&2
22.     exit 1
23. fi
25. echo "使用SVN命令: $SVN_CMD"
26. echo "使用工作目录: $WORK_DIR"

复制代码

5. 字符编码问题

问题：提交信息包含非ASCII字符时，出现编码问题。

解决方案：

• 确保系统locale设置正确
• 使用UTF-8编码处理文本
• 在SVN命令中指定编码

2. #!/bin/bash
4. # 设置locale为UTF-8
5. export LANG=en_US.UTF-8
6. export LC_ALL=en_US.UTF-8
8. # 创建UTF-8编码的临时日志文件
9. TEMP_LOG=$(mktemp)
10. echo "提交信息包含中文: 测试" > "$TEMP_LOG"
12. # 使用UTF-8编码提交
13. $SVN_CMD commit -F "$TEMP_LOG" --encoding UTF-8
15. # 清理临时文件
16. rm -f "$TEMP_LOG"

复制代码

总结

通过本教程，我们详细介绍了SVN提交脚本的编写方法，从基础到高级，涵盖了日常版本控制中常见的难题和解决方案。我们学习了如何编写简单提交脚本、带日志模板的提交脚本、自动冲突解决的提交脚本、分支管理脚本以及集成自动化测试的提交脚本。

编写SVN提交脚本不仅可以提高工作效率，减少人为错误，还可以确保团队遵循统一的版本控制规范。通过自动化测试集成、冲突解决、分支管理等功能，我们可以更好地管理项目开发流程。

在实际应用中，建议根据团队的具体需求和项目特点，选择和定制适合的脚本。同时，良好的错误处理、日志记录和配置管理也是脚本成功应用的关键因素。

希望本教程能帮助你更好地掌握SVN提交脚本的编写，解决日常版本控制中的难题，提高团队的开发效率和代码质量。