引言：SVN版本控制的核心查看功能
Subversion（简称SVN）是一个集中式的版本控制系统，广泛应用于软件开发、文档管理等领域。在日常使用SVN的过程中，查看文件的版本号和历史记录是最基本也是最重要的操作之一。通过这些操作，我们可以了解文件的变更历史、追踪bug来源、恢复误删文件，以及协作开发时了解同事的修改意图。
本文将详细讲解SVN中两个核心命令——
svn log
和
svn info
的使用技巧，并结合实际案例说明常见问题的排查方法。无论你是SVN新手还是有一定经验的用户，相信都能从中获得实用的知识。
一、SVN基础概念回顾
1.1 什么是版本号？
在SVN中，每次提交都会产生一个全局递增的版本号（Revision），这个版本号是整个仓库的版本号，而不是单个文件的版本号。例如，当你提交一个文件时，整个仓库的版本号会递增1，这个版本号会标记这次提交的所有变更。
1.2 什么是历史记录？
历史记录是指一个文件或目录在SVN仓库中所有变更的记录，包括每次变更的版本号、作者、提交时间、修改内容描述以及实际的代码差异。
二、svn info命令详解
2.1 基本用法
svn info
命令用于显示文件或目录的详细信息，包括当前版本号、最后修改的版本号、作者、提交时间等。
基本语法：
svn info [PATH]
示例：
假设我们有一个文件
example.txt
，位于工作副本的根目录下。
$ svn info example.txt
输出结果：
Path: example.txt
Name: example.txt
Working Copy Root Path: /home/user/project
URL: https://svn.example.com/svn/project/trunk/example.txt
Relative URL: ^/trunk/example.txt
Repository Root: https://svn.example.com/svn/project
Repository UUID: 12345678-1234-1234-1234-123456789012
Revision: 1234
Node Kind: file
Schedule: normal
Last Changed Author: john
Last Changed Rev: 1230
Last Changed Date: 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023)
Text Last Updated: 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023)
Checksum: a1b2c3d4e5f6…
2.2 输出字段详解
Path
: 文件或目录在本地工作副本中的路径。
Working Copy Root Path
: 工作副本的根目录路径。
URL
: 该文件或目录在SVN仓库中的完整URL。
Relative URL
: 相对于仓库根目录的相对URL。
Repository Root
: 仓库的根URL。
Repository UUID
: 仓库的唯一标识符。
Revision
: 当前工作副本的版本号（注意：这可能是文件的最后更新版本，不一定是最新的仓库版本）。
Node Kind
: 节点类型（file、dir等）。
Schedule
: 标记该文件是否计划进行添加、删除等操作（normal表示正常）。
Last Changed Author
: 最后一次修改该文件的作者。
Last Changed Rev
: 最后一次修改该文件的版本号。
Last Changed Date
: 最后一次修改的时间。
Text Last Updated
: 文件内容最后更新时间。
Checksum
: 文件内容的校验和。
2.3 查看远程仓库信息
使用
svn info
时，如果想查看远程仓库中文件的最新信息（而不只是本地工作副本的信息），可以使用
–show-updates
选项。
$ svn info –show-updates example.txt
输出结果：
Path: example.txt
Name: example.txt
…
Revision: 1234
Node Kind: file
Schedule: normal
Last Changed Author: john
Last Changed Rev: 1230
Last Changed Date: 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023)
Text Last Updated: 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023)
Checksum: a1b2c3d4e5f6…
Repository Root: https://svn.example.com/svn/project
Repository UUID: 12345678-1234-1234-1234-123456789012
URL: https://svn.example.com/svn/project/trunk/example.txt
Relative URL: ^/trunk/example.txt
注意：
–show-updates
选项会与服务器通信，显示服务器上的最新版本信息，但不会更新本地文件。
2.4 查看历史版本信息
svn info
也可以查看某个历史版本的信息，使用
-r
选项指定版本号。
$ svn info -r 1200 example.txt
输出结果：
Path: example.txt
Name: example.txt
…
Revision: 1200
Node Kind: file
Schedule: normal
Last Changed Author: alice
Last Changed Rev: 1198
Last Changed Date: 2023-10-10 10:15:22 +0800 (Mon, 10 Oct 2023)
…
2.5 查看目录信息
svn info
不仅可以查看文件信息，也可以查看目录信息。
$ svn info mydir/
输出结果：
Path: mydir
Name: mydir
Working Copy Root Path: /home/user/project
URL: https://svn.example.com/svn/project/trunk/mydir
Relative URL: ^/trunk/mydir
Repository Root: https://svn.example.com/svn/project
Repository UUID: 12345678-1234-1234-1234-123456789012
Revision: 1234
Node Kind: directory
Schedule: normal
Last Changed Author: bob
Last Changed Rev: 1225
Last Changed Date: 2023-10-12 09:45:33 +0800 (Thu, 12 Oct 2023)
2.6 常见问题排查
问题1：svn info 显示的版本号与预期不符
现象
：执行
svn info
后，显示的
Revision
不是当前仓库的最新版本号。
原因
：
svn info
显示的是当前工作副本的版本号，即你最后一次更新或提交的版本号。如果你没有更新工作副本，这个版本号可能低于仓库的最新版本。
解决方法
：
使用
svn update
更新工作副本到最新版本。
使用
svn info –show-updates
查看服务器上的最新版本号。
问题2：文件状态为 “missing” 或 “obstructed”
现象
：在
svn info
的输出中，
Schedule
字段显示为
missing
或
obstructed
。
原因
：
missing
：表示该文件在本地被删除，但未通过SVN命令删除，SVN认为它丢失了。
obstructed
：表示该文件在本地存在，但SVN期望它是一个目录（或相反），或者文件类型不匹配。
解决方法
：
对于
missing
：使用
svn revert
恢复文件，或者使用
svn delete
正式删除。
对于
obstructed
：检查文件系统，确保文件类型与SVN记录一致，必要时使用
svn cleanup
清理工作副本。
问题3：无法访问仓库
现象
：执行
svn info
时出现错误，如 “Unable to connect to repository” 或 “Repository moved permanently”。
原因
：网络问题、仓库URL变更、认证失败等。
解决方法
：
检查网络连接。
使用
svn info
查看当前URL，确认仓库地址是否正确。
如果仓库URL变更，使用
svn relocate
重新定位。
检查认证信息，必要时重新输入用户名密码。
三、svn log命令详解
3.1 基本用法
svn log
命令用于显示文件或目录的提交历史记录，包括每次提交的版本号、作者、日期和提交信息。
基本语法：
svn log [PATH]
示例：
$ svn log example.txt
输出结果：
————————————————————————
r1234 | john | 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023) | 1 line
Updated the documentation section about installation.
————————————————————————
r1230 | alice | 2023-10-14 11:20:33 +0800 (Sat, 14 Oct 2023) | 2 lines
Fixed bug #456 in the login module.
Added error handling for invalid credentials.
————————————————————————
r1225 | bob | 2023-10-12 09:45:33 +0800 (Thu, 12 Oct 2023) | 3 lines
Initial commit of the example.txt file.
This file contains basic examples for the project.
It will be updated regularly.
3.2 输出格式详解
每个提交记录由以下部分组成：
版本号
：以
r
开头，例如
r1234
。
作者
：提交该变更的用户。
日期和时间
：提交的具体时间。
提交信息
：用户在提交时填写的描述信息，通常简要说明本次变更的目的。
3.3 查看指定版本范围
使用
-r
选项可以查看指定版本范围的日志。
查看单个版本：
$ svn log -r 1230 example.txt
查看多个版本（连续范围）：
$ svn log -r 1225:1234 example.txt
查看多个版本（不连续范围）：
$ svn log -r 1225,1230,1234 example.txt
查看最新版本（HEAD）：
$ svn log -r HEAD example.txt
查看从某个版本到最新版本：
版本号：**
“`bash
$ svn log -r 1200:HEAD example.txt
3.4 限制日志数量
使用
-l
（或
–limit
）选项限制显示的提交记录数量。
$ svn log -l 5 example.txt # 只显示最近的5条记录
3.5 查看详细差异
使用
-v
（或
–verbose
）选项可以在日志中显示每次提交的具体修改内容（diff）。
$ svn log -v example.txt
输出结果：
————————————————————————
r1234 | john | 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023) | 1 line
Changed paths:
M /trunk/example.txt
Updated the documentation section about installation.
===================================================================
— /trunk/example.txt (revision 1233)
+++ /trunk/example.txt (revision 1234)
@@ -10,7 +10,7 @@
To install this software, follow these steps:
1. Download the package.
-2. Run the installer.
+2. Run the installer as administrator.
3. Follow the on-screen instructions.
————————————————————————
r1230 | alice | 2023-10-14 11:20:33 +0800 (Sat, 14 Oct 2023) | 2 lines
Changed paths:
M /trunk/example.txt
Fixed bug #456 in the login module.
===================================================================
— /trunk/example.txt (revision 1229)
+++ /trunk/example.txt (revision 1230)
@@ -5,6 +5,8 @@
The login module is used for user authentication.
+Note: Error handling has been added for invalid credentials.
+
If you encounter issues, please check the logs.
————————————————————————
r1225 | bob | 2023-10-12 09:45:33 +0800 (Thu, 12 Oct 2023) | 3 lines
Changed paths:
A /trunk/example.txt
Initial commit of the example.txt file.
===================================================================
This file contains basic examples for the project.
It will be …
—
3.6 查看不同工作副本的差异
使用
svn log
时，可以结合
–stop-on-copy
选项，这样SVN会停止在复制或移动操作之前，常用于查看分支的创建历史。
$ svn log –stop-on-copy https://svn.example.com/svn/project/branches/feature-branch
3.7 查看两个版本之间的差异
使用
svn diff
结合
svn log
可以查看两个版本之间的差异，但
svn log
本身不直接支持比较两个版本的日志。不过，我们可以使用
svn log -r
结合
svn diff
来查看差异。
例如，查看版本1225和1234之间的差异：
$ svn diff -r 1225:1234 example.txt
3.8 常见问题排查
问题1：svn log 显示的日志不全
现象
：执行
svn log
后，只显示部分提交记录，或者某些预期的提交记录没有显示。
原因
：
使用了
-l
选项限制了显示数量。
指定了错误的版本范围。
文件或目录被移动或复制，历史记录可能不连续。
权限问题，某些提交记录对当前用户不可见。
解决方法
：
检查是否使用了
-l
选项，适当增加限制数量或移除该选项。
使用
-r
选项指定完整的版本范围，例如
svn log -r 1:HEAD
。
使用
–stop-on-copy
选项查看完整历史。
联系SVN管理员确认权限。
问题2：svn log 显示 “svn: E200007: Retrieval of mergeinfo unsupported”
现象
：在查看日志时出现错误提示 “Retrieval of mergeinfo unsupported”。
原因
：SVN 1.5之前版本不支持mergeinfo（合并信息）的存储和查询，或者服务器版本过低。
解决方法
：
升级SVN服务器和客户端到较新版本（建议1.5以上）。
如果无法升级，避免使用合并相关的操作。
问题3：svn log 显示乱码
现象
：日志中的中文或其他非ASCII字符显示为乱码。
原因
：字符编码不匹配，SVN客户端和服务器的编码设置不一致。
解决方法
：
设置正确的环境变量，例如在Linux下设置
export LANG=en_US.UTF-8
。
在Windows下，确保命令行终端使用UTF-8编码。
检查SVN配置文件（~/.subversion/config）中的
log-encoding
设置。
四、svn log与svn info的结合使用
4.1 查看文件的完整信息
结合
svn info
和
svn log
，可以全面了解一个文件的状态和历史。
示例：
# 查看文件基本信息
$ svn info example.txt
# 查看文件最近5次提交记录
$ svn log -l 5 example.txt
4.2 追踪文件变更历史
通过
svn log
查看变更记录，结合
svn diff
查看具体差异，可以追踪文件的变更历史。
示例：
# 查看版本1230到1234之间的差异
$ svn diff -r 1230:1234 example.txt
# 查看版本1230的提交信息
$ svn log -r 1230 example.txt
4.3 查找特定变更
使用
svn log
的
-v
选项和
grep
命令可以查找特定的变更。
示例：
# 查找包含 “bug” 的提交记录
$ svn log -v example.txt | grep -i “bug”
4.4 查看分支历史
查看分支的创建和合并历史，可以使用
svn log –stop-on-copy
。
示例：
$ svn log –stop-on-copy https://svn.example.com/svn/project/branches/feature-branch
五、高级技巧与最佳实践
5.1 使用别名简化命令
在SVN配置文件中设置别名，可以简化常用命令。
编辑
~/.subversion/config
文件，添加：
[aliases]
info = info –show-updates
log = log -v
然后可以使用：
$ svn info example.txt # 实际执行 svn info –show-updates example.txt
$ svn log example.txt # 实际执行 svn log -v example.txt
5.2 结合grep过滤输出
使用管道结合grep命令，可以快速过滤日志信息。
示例：
# 查找某个作者的所有提交
$ svn log | grep -A 5 “author: john”
# 查找某个日期范围的提交
$ svn log | grep “2023-10-15”
5.3 使用svn log输出到文件
将日志输出到文件，便于后续分析。
$ svn log -r 1:HEAD > svn_log.txt
5.4 查看目录下所有文件的变更历史
使用递归方式查看目录下所有文件的变更历史。
$ svn log -R mydir/
5.5 使用svn log –xml进行脚本处理
svn log
支持XML格式输出，便于脚本解析。
$ svn log –xml example.txt
XML输出示例：
Added error handling for invalid credentials.
六、常见问题汇总与排查
6.1 工作副本锁定
问题
：执行
svn log
或
svn info
时出现 “Working copy locked” 错误。
原因
：工作副本可能因为之前的异常操作（如强制终止SVN命令）而被锁定。
解决方法
：
$ svn cleanup
6.2 版本号不存在
问题
：指定版本号时出现 “File not found: revision 1234, path ‘/trunk/example.txt’” 错误。
原因
：指定的版本号不存在，或者该版本中文件尚未创建或已被删除。
解决方法
：
使用
svn log
查看文件的创建版本和删除版本。
确认版本号是否在文件的生命周期内。
6.3 权限不足
问题
：执行命令时出现 “Access denied” 或 “Authorization failed” 错误。
原因
：当前用户没有权限访问该文件或目录。
解决方法
：
联系SVN管理员确认权限。
使用
svn info
查看当前URL，确认是否有权限访问。
6.4 网络问题
问题
：执行命令时出现 “Connection timed out” 或 “Unable to connect to repository” 错误。
原因
：网络连接问题或SVN服务器不可用。
解决方法
：
检查网络连接。
使用
ping
或
telnet
测试SVN服务器的连通性。
如果使用代理，检查代理设置。
6.5 认证缓存问题
问题
：SVN提示输入用户名密码，但输入正确后仍然提示认证失败。
**
原因
：认证缓存可能已损坏或过期。
解决方法
：
清除认证缓存：
Linux: 删除
~/.subversion/auth
目录下的相关文件。
Windows: 删除
%APPDATA%\Subversion\auth
目录下的相关文件。
重新执行SVN命令，输入正确的用户名密码。
七、总结
本文详细介绍了SVN中查看文件版本号和历史记录的两个核心命令——
svn log
和
svn info
。通过这两个命令，我们可以获取文件的基本信息、变更历史、提交详情以及差异比较。掌握这些命令的使用技巧和常见问题排查方法，能够帮助我们更高效地使用SVN进行版本控制。
在实际使用中，建议结合
svn info
和
svn log
的输出，全面了解文件状态和历史。同时，利用高级技巧如XML输出、结合grep过滤等，可以进一步提升工作效率。遇到问题时，按照本文提供的排查方法，大部分问题都能得到快速解决。
最后，保持良好的提交习惯，编写清晰的提交信息，也是高效使用SVN的重要一环。希望本文对你的SVN使用有所帮助！
# SVN如何查看文件版本号与历史记录 详解svn log和svn info命令的使用技巧与常见问题排查
引言：SVN版本控制的核心查看功能
Subversion（简称SVN）是一个集中式的版本控制系统，广泛应用于软件开发、文档管理等领域。在日常使用SVN的过程中，查看文件的版本号和历史记录是最基本也是最重要的操作之一。通过这些操作，我们可以了解文件的变更历史、追踪bug来源、恢复误删文件，以及协作开发时了解同事的修改意图。
本文将详细讲解SVN中两个核心命令——
svn log
和
svn info
的使用技巧，并结合实际案例说明常见问题的排查方法。无论你是SVN新手还是有一定经验的用户，相信都能从中获得实用的知识。
一、SVN基础概念回顾
1.1 什么是版本号？
在SVN中，每次提交都会产生一个全局递增的版本号（Revision），这个版本号是整个仓库的版本号，而不是单个文件的版本号。例如，当你提交一个文件时，整个仓库的版本号会递增1，这个版本号会标记这次提交的所有变更。
1.2 什么是历史记录？
历史记录是指一个文件或目录在SVN仓库中所有变更的记录，包括每次变更的版本号、作者、提交时间、修改内容描述以及实际的代码差异。
二、svn info命令详解
2.1 基本用法
svn info
命令用于显示文件或目录的详细信息，包括当前版本号、最后修改的版本号、作者、提交时间等。
基本语法：
svn info [PATH]
示例：
假设我们有一个文件
example.txt
，位于工作副本的根目录下。
$ svn info example.txt
输出结果：
Path: example.txt
Name: example.txt
Working Copy Root Path: /home/user/project
URL: https://svn.example.com/svn/project/trunk/example.txt
Relative URL: ^/trunk/example.txt
Repository Root: https://svn.example.com/svn/project
Repository UUID: 12345678-1234-1234-1234-123456789012
Revision: 1234
Node Kind: file
Schedule: normal
Last Changed Author: john
Last Changed Rev: 1230
Last Changed Date: 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023)
Text Last Updated: 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023)
Checksum: a1b2c3d4e5f6…
2.2 输出字段详解
Path
: 文件或目录在本地工作副本中的路径。
Working Copy Root Path
: 工作副本的根目录路径。
URL
: 该文件或目录在SVN仓库中的完整URL。
Relative URL
: 相对于仓库根目录的相对URL。
Repository Root
: 仓库的根URL。
Repository UUID
: 仓库的唯一标识符。
Revision
: 当前工作副本的版本号（注意：这可能是文件的最后更新版本，不一定是最新的仓库版本）。
Node Kind
: 节点类型（file、dir等）。
Schedule
: 标记该文件是否计划进行添加、删除等操作（normal表示正常）。
Last Changed Author
: 最后一次修改该文件的作者。
Last Changed Rev
: 最后一次修改该文件的版本号。
Last Changed Date
: 最后一次修改的时间。
Text Last Updated
: 文件内容最后更新时间。
Checksum
: 文件内容的校验和。
2.3 查看远程仓库信息
使用
svn info
时，如果想查看远程仓库中文件的最新信息（而不只是本地工作副本的信息），可以使用
–show-updates
选项。
$ svn info –show-updates example.txt
输出结果：
Path: example.txt
Name: example.txt
…
Revision: 1234
Node Kind: file
Schedule: normal
Last Changed Author: john
Last Changed Rev: 1230
Last Changed Date: 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023)
Text Last Updated: 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023)
Checksum: a1b2c3d4e5f6…
Repository Root: https://svn.example.com/svn/project
Repository UUID: 12345678-1234-1234-1234-123456789012
URL: https://svn.example.com/svn/project/trunk/example.txt
Relative URL: ^/trunk/example.txt
注意：
–show-updates
选项会与服务器通信，显示服务器上的最新版本信息，但不会更新本地文件。
2.4 查看历史版本信息
svn info
也可以查看某个历史版本的信息，使用
-r
选项指定版本号。
$ svn info -r 1200 example.txt
输出结果：
Path: example.txt
Name: example.txt
…
Revision: 1200
Node Kind: file
Schedule: normal
Last Changed Author: alice
Last Changed Rev: 1198
Last Changed Date: 2023-10-10 10:15:22 +0800 (Mon, 10 Oct 2023)
…
2.5 查看目录信息
svn info
不仅可以查看文件信息，也可以查看目录信息。
$ svn info mydir/
输出结果：
Path: mydir
Name: mydir
Working Copy Root Path: /home/user/project
URL: https://svn.example.com/svn/project/trunk/mydir
Relative URL: ^/trunk/mydir
Repository Root: https://svn.example.com/svn/project
Repository UUID: 12345678-1234-1234-1234-123456789012
Revision: 1234
Node Kind: directory
Schedule: normal
Last Changed Author: bob
Last Changed Rev: 1225
Last Changed Date: 2023-10-12 09:45:33 +0800 (Thu, 12 Oct 2023)
2.6 常见问题排查
问题1：svn info 显示的版本号与预期不符
现象
：执行
svn info
后，显示的
Revision
不是当前仓库的最新版本号。
原因
：
svn info
显示的是当前工作副本的版本号，即你最后一次更新或提交的版本号。如果你没有更新工作副本，这个版本号可能低于仓库的最新版本。
解决方法
：
使用
svn update
更新工作副本到最新版本。
使用
svn info –show-updates
查看服务器上的最新版本号。
问题2：文件状态为 “missing” 或 “obstructed”
现象
：在
svn info
的输出中，
Schedule
字段显示为
missing
或
obstructed
。
原因
：
missing
：表示该文件在本地被删除，但未通过SVN命令删除，SVN认为它丢失了。
obstructed
：表示该文件在本地存在，但SVN期望它是一个目录（或相反），或者文件类型不匹配。
解决方法
：
对于
missing
：使用
svn revert
恢复文件，或者使用
svn delete
正式删除。
对于
obstructed
：检查文件系统，确保文件类型与SVN记录一致，必要时使用
svn cleanup
清理工作副本。
问题3：无法访问仓库
现象
：执行
svn info
时出现错误，如 “Unable to connect to repository” 或 “Repository moved permanently”。
原因
：网络问题、仓库URL变更、认证失败等。
解决方法
：
检查网络连接。
使用
svn info
查看当前URL，确认仓库地址是否正确。
如果仓库URL变更，使用
svn relocate
重新定位。
检查认证信息，必要时重新输入用户名密码。
三、svn log命令详解
3.1 基本用法
svn log
命令用于显示文件或目录的提交历史记录，包括每次提交的版本号、作者、日期和提交信息。
基本语法：
svn log [PATH]
示例：
$ svn log example.txt
输出结果：
————————————————————————
r1234 | john | 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023) | 1 line
Updated the documentation section about installation.
————————————————————————
r1230 | alice | 2023-10-14 11:20:33 +0800 (Sat, 14 Oct 2023) | 2 lines
Fixed bug #456 in the login module.
Added error handling for invalid credentials.
————————————————————————
r1225 | bob | 2023-10-12 09:45:33 +0800 (Thu, 12 Oct 2023) | 3 lines
Initial commit of the example.txt file.
This file contains basic examples for the project.
It will be updated regularly.
3.2 输出格式详解
每个提交记录由以下部分组成：
版本号
：以
r
开头，例如
r1234
。
作者
：提交该变更的用户。
日期和时间
：提交的具体时间。
提交信息
：用户在提交时填写的描述信息，通常简要说明本次变更的目的。
3.3 查看指定版本范围
使用
-r
选项可以查看指定版本范围的日志。
查看单个版本：
$ svn log -r 1230 example.txt
查看多个版本（连续范围）：
$ svn log -r 1225:1234 example.txt
查看多个版本（不连续范围）：
$ svn log -r 1225,1230,1234 example.txt
查看最新版本（HEAD）：
$ svn log -r HEAD example.txt
查看从某个版本到最新版本：
$ svn log -r 1200:HEAD example.txt
3.4 限制日志数量
使用
-l
（或
–limit
）选项限制显示的提交记录数量。
$ svn log -l 5 example.txt # 只显示最近的5条记录
3.5 查看详细差异
使用
-v
（或
–verbose
）选项可以在日志中显示每次提交的具体修改内容（diff）。
$ svn log -v example.txt
输出结果：
————————————————————————
r1234 | john | 2023-10-15 14:30:56 +0800 (Sun, 15 Oct 2023) | 1 line
Changed paths:
M /trunk/example.txt
Updated the documentation section about installation.
===================================================================
— /trunk/example.txt (revision 1233)
+++ /trunk/example.txt (revision 1234)
@@ -10,7 +10,7 @@
To install this software, follow these steps:
1. Download the package.
-2. Run the installer.
+2. Run the installer as administrator.
3. Follow the on-screen instructions.
————————————————————————
r1230 | alice | 2023-10-14 11:20:33 +0800 (Sat, 14 Oct 2023) | 2 lines
Changed paths:
M /trunk/example.txt
Fixed bug #456 in the login module.
===================================================================
— /trunk/example.txt (revision 1229)
+++ /trunk/example.txt (revision 1230)
@@ -5,6 +5,8 @@
The login module is used for user authentication.
+Note: Error handling has been added for invalid credentials.
+
If you encounter issues, please check the logs.
————————————————————————
r1225 | bob | 2023-10-12 09:45:33 +0800 (Thu, 12 Oct 2023) | 3 lines
Changed paths:
A /trunk/example.txt
Initial commit of the example.txt file.
===================================================================
This file contains basic examples for the project.
It will be …
—
3.6 查看不同工作副本的差异
使用
svn log
时，可以结合
–stop-on-copy
选项，这样SVN会停止在复制或移动操作之前，常用于查看分支的创建历史。
$ svn log –stop-on-copy https://svn.example.com/svn/project/branches/feature-branch
3.7 查看两个版本之间的差异
使用
svn diff
结合
svn log
可以查看两个版本之间的差异，但
svn log
本身不直接支持比较两个版本的日志。不过，我们可以使用
svn log -r
结合
svn diff
来查看差异。
例如，查看版本1225和1234之间的差异：
$ svn diff -r 1225:1234 example.txt
3.8 常见问题排查
问题1：svn log 显示的日志不全
现象
：执行
svn log
后，只显示部分提交记录，或者某些预期的提交记录没有显示。
原因
：
使用了
-l
选项限制了显示数量。
指定了错误的版本范围。
文件或目录被移动或复制，历史记录可能不连续。
权限问题，某些提交记录对当前用户不可见。
解决方法
：
检查是否使用了
-l
选项，适当增加限制数量或移除该选项。
使用
-r
选项指定完整的版本范围，例如
svn log -r 1:HEAD
。
使用
–stop-on-copy
选项查看完整历史。
联系SVN管理员确认权限。
问题2：svn log 显示 “svn: E200007: Retrieval of mergeinfo unsupported”
现象
：在查看日志时出现错误提示 “Retrieval of mergeinfo unsupported”。
原因
：SVN 1.5之前版本不支持mergeinfo（合并信息）的存储和查询，或者服务器版本过低。
解决方法
：
升级SVN服务器和客户端到较新版本（建议1.5以上）。
如果无法升级，避免使用合并相关的操作。
问题3：svn log 显示乱码
现象
：日志中的中文或其他非ASCII字符显示为乱码。
原因
：字符编码不匹配，SVN客户端和服务器的编码设置不一致。
解决方法
：
设置正确的环境变量，例如在Linux下设置
export LANG=en_US.UTF-8
。
在Windows下，确保命令行终端使用UTF-8编码。
检查SVN配置文件（~/.subversion/config）中的
log-encoding
设置。
四、svn log与svn info的结合使用
4.1 查看文件的完整信息
结合
svn info
和
svn log
，可以全面了解一个文件的状态和历史。
示例：
# 查看文件基本信息
$ svn info example.txt
# 查看文件最近5次提交记录
$ svn log -l 5 example.txt
4.2 追踪文件变更历史
通过
svn log
查看变更记录，结合
svn diff
查看具体差异，可以追踪文件的变更历史。
示例：
# 查看版本1230到1234之间的差异
$ svn diff -r 1230:1234 example.txt
# 查看版本1230的提交信息
$ svn log -r 1230 example.txt
4.3 查找特定变更
使用
svn log
的
-v
选项和
grep
命令可以查找特定的变更。
示例：
# 查找包含 “bug” 的提交记录
$ svn log -v example.txt | grep -i “bug”
4.4 查看分支历史
查看分支的创建和合并历史，可以使用
svn log –stop-on-copy
。
示例：
$ svn log –stop-on-copy https://svn.example.com/svn/project/branches/feature-branch
五、高级技巧与最佳实践
5.1 使用别名简化命令
在SVN配置文件中设置别名，可以简化常用命令。
编辑
~/.subversion/config
文件，添加：
[aliases]
info = info –show-updates
log = log -v
然后可以使用：
$ svn info example.txt # 实际执行 svn info –show-updates example.txt
$ svn log example.txt # 实际执行 svn log -v example.txt
5.2 结合grep过滤输出
使用管道结合grep命令，可以快速过滤日志信息。
示例：
# 查找某个作者的所有提交
$ svn log | grep -A 5 “author: john”
# 查找某个日期范围的提交
$ svn log | grep “2023-10-15”
5.3 使用svn log输出到文件
将日志输出到文件，便于后续分析。
$ svn log -r 1:HEAD > svn_log.txt
5.4 查看目录下所有文件的变更历史
使用递归方式查看目录下所有文件的变更历史。
$ svn log -R mydir/
5.5 使用svn log –xml进行脚本处理
svn log
支持XML格式输出，便于脚本解析。
$ svn log –xml example.txt
XML输出示例：
Added error handling for invalid credentials.
六、常见问题汇总与排查
6.1 工作副本锁定
问题
：执行
svn log
或
svn info
时出现 “Working copy locked” 错误。
原因
：工作副本可能因为之前的异常操作（如强制终止SVN命令）而被锁定。
解决方法
：
$ svn cleanup
6.2 版本号不存在
问题
：指定版本号时出现 “File not found: revision 1234, path ‘/trunk/example.txt’” 错误。
原因
：指定的版本号不存在，或者该版本中文件尚未创建或已被删除。
解决方法
：
使用
svn log
查看文件的创建版本和删除版本。
确认版本号是否在文件的生命周期内。
6.3 权限不足
问题
：执行命令时出现 “Access denied” 或 “Authorization failed” 错误。
原因
：当前用户没有权限访问该文件或目录。
解决方法
：
联系SVN管理员确认权限。
使用
svn info
查看当前URL，确认是否有权限访问。
6.4 网络问题
问题
：执行命令时出现 “Connection timed out” 或 “Unable to connect to repository” 错误。
原因
：网络连接问题或SVN服务器不可用。
解决方法
：
检查网络连接。
使用
ping
或
telnet
测试SVN服务器的连通性。
如果使用代理，检查代理设置。
6.5 认证缓存问题
问题
：SVN提示输入用户名密码，但输入正确后仍然提示认证失败。
原因
：认证缓存可能已损坏或过期。
解决方法
：
清除认证缓存：
Linux: 删除
~/.subversion/auth
目录下的相关文件。
Windows: 删除
%APPDATA%\Subversion\auth
目录下的相关文件。
重新执行SVN命令，输入正确的用户名密码。
七、总结
本文详细介绍了SVN中查看文件版本号和历史记录的两个核心命令——
svn log
和
svn info
。通过这两个命令，我们可以获取文件的基本信息、变更历史、提交详情以及差异比较。掌握这些命令的使用技巧和常见问题排查方法，能够帮助我们更高效地使用SVN进行版本控制。
在实际使用中，建议结合
svn info
和
svn log
的输出，全面了解文件状态和历史。同时，利用高级技巧如XML输出、结合grep过滤等，可以进一步提升工作效率。遇到问题时，按照本文提供的排查方法，大部分问题都能得到快速解决。
最后，保持良好的提交习惯，编写清晰的提交信息，也是高效使用SVN的重要一环。希望本文对你的SVN使用有所帮助！