SVN提交时出现加号标记的含义及解决方法 新增文件版本控制全攻略

威震华夏关云长

1. SVN基础介绍

Subversion（SVN）是一个开源的版本控制系统，用于管理文件和目录的变更。它采用客户端/服务器架构，允许多个开发者协同工作，同时追踪每个文件的修改历史。SVN通过”复制-修改-合并”模型来支持并行开发，是许多软件开发团队的首选版本控制工具。

1.1 SVN基本工作流程

基本工作流程包括：

• 检出（Checkout）：从版本库获取工作副本
• 更新（Update）：将版本库的最新更改同步到本地工作副本
• 修改（Modify）：编辑工作副本中的文件
• 提交（Commit）：将本地更改发送到版本库

2. SVN提交时加号标记的含义

在使用SVN进行版本控制时，你可能会在提交操作时看到文件旁边有一个加号（+）标记。这个标记在SVN中有特定的含义，理解它对于正确使用版本控制系统至关重要。

2.1 加号标记的基本含义

加号（+）标记表示该文件是一个新增文件，即：

• 文件存在于你的工作副本中
• 文件尚未被版本控制（不在SVN版本库中）
• 文件已被标记为添加到版本控制（使用svn add命令）

当你执行svn status命令时，新增文件前面会显示”A”（表示Added），而在某些SVN客户端的可视化界面中，这些文件可能会用加号标记表示。

2. $ svn status
3. A       newfile.txt
4. M       modifiedfile.txt
5. ?       untrackedfile.txt

复制代码

在上面的示例中，newfile.txt前面有”A”标记，表示它是一个已标记为添加的新文件。

2.2 加号标记在提交过程中的显示

在某些SVN客户端（如TortoiseSVN）中，当你准备提交更改时，新增文件旁边会显示一个加号图标，直观地表示这是一个将要被添加到版本库的新文件。

3. 出现加号标记的原因

加号标记出现的原因主要有以下几种：

3.1 显式添加新文件

最常见的情况是你明确地添加了一个新文件到版本控制：

2. # 创建一个新文件
3. $ echo "This is a new file" > newfile.txt
5. # 将文件添加到版本控制
6. $ svn add newfile.txt
7. A         newfile.txt

复制代码

3.2 复制已有文件

当你复制一个已经在版本控制下的文件时，SVN会自动将新文件标记为添加：

2. # 复制一个已版本控制的文件
3. $ svn copy existingfile.txt newfile.txt
4. A         newfile.txt

复制代码

3.3 创建目录并添加文件

创建新目录并添加文件也会导致加号标记的出现：

2. # 创建新目录
3. $ mkdir newdir
5. # 添加目录到版本控制
6. $ svn add newdir
7. A         newdir
9. # 在目录中创建文件并添加
10. $ echo "File in new directory" > newdir/file_in_dir.txt
11. $ svn add newdir/file_in_dir.txt
12. A         newdir/file_in_dir.txt

复制代码

3.4 恢复删除的文件

当你恢复一个之前删除的文件时，它也会被标记为新增文件：

2. # 假设文件之前被删除了
3. $ svn delete deletedfile.txt
4. D         deletedfile.txt
6. # 恢复删除的文件
7. $ svn copy deletedfile.txt@PREV deletedfile.txt
8. A         deletedfile.txt

复制代码

4. 加号标记的解决方法

虽然加号标记通常表示正常的新增文件操作，但有时你可能需要处理或解决与这些标记相关的问题。以下是一些常见的解决方法：

4.1 正常提交新增文件

最简单的情况是，你确实想要将这些新增文件提交到版本库。只需执行提交操作：

2. $ svn commit -m "Add new files"
3. Adding         newfile.txt
4. Adding         newdir
5. Adding         newdir/file_in_dir.txt
6. Transmitting file data .
7. Committed revision 123.

复制代码

4.2 取消添加文件

如果你不小心添加了不想版本控制的文件，可以使用以下命令取消添加：

2. $ svn add newfile.txt
3. A         newfile.txt
5. # 改变主意，不想添加这个文件了
6. $ svn revert newfile.txt
7. Reverted 'newfile.txt'

复制代码

4.3 忽略特定文件或模式

如果你有一些文件或文件类型不想被版本控制，可以设置SVN忽略它们：

2. # 编辑svn:ignore属性
3. $ svn propedit svn:ignore .
5. # 在打开的编辑器中添加要忽略的文件模式，例如：
6. *.tmp
7. *.log
8. build/
9. dist/
11. # 保存并退出编辑器

复制代码

或者直接使用命令设置忽略属性：

2. $ svn propset svn:ignore "*.tmp
3. *.log
4. build/" .

复制代码

4.4 解决冲突

在某些情况下，新增文件可能会与版本库中的其他更改产生冲突。解决冲突的步骤如下：

2. # 首先更新工作副本
3. $ svn update
5. # 如果出现冲突，解决它
6. # 对于新增文件的冲突，通常需要重命名你的文件
7. $ mv newfile.txt newfile_renamed.txt
9. # 然后重新添加并提交
10. $ svn add newfile_renamed.txt
11. $ svn commit -m "Add renamed file to avoid conflict"

复制代码

4.5 批量处理新增文件

当你有大量新增文件需要处理时，可以使用一些批处理技巧：

2. # 查看所有新增文件
3. $ svn status | grep "^A"
5. # 批量取消添加所有新增文件
6. $ svn status | grep "^A" | awk '{print $2}' | xargs svn revert
8. # 批量提交所有新增文件
9. $ svn status | grep "^A" | awk '{print $2}' | xargs svn add
10. $ svn commit -m "Batch add new files"

复制代码

5. 新增文件版本控制全攻略

有效管理新增文件是SVN版本控制的重要部分。以下是一份全面的新增文件版本控制指南。

5.1 添加单个文件

添加单个文件到版本控制是最基本的操作：

2. # 创建新文件
3. $ echo "Content of new file" > newfile.txt
5. # 添加文件到版本控制
6. $ svn add newfile.txt
7. A         newfile.txt
9. # 提交更改
10. $ svn commit -m "Add newfile.txt with initial content"
11. Adding         newfile.txt
12. Transmitting file data .
13. Committed revision 124.

复制代码

5.2 添加多个文件

你可以一次性添加多个文件：

2. # 创建多个文件
3. $ echo "File 1 content" > file1.txt
4. $ echo "File 2 content" > file2.txt
5. $ echo "File 3 content" > file3.txt
7. # 添加多个文件
8. $ svn add file1.txt file2.txt file3.txt
9. A         file1.txt
10. A         file2.txt
11. A         file3.txt
13. # 提交更改
14. $ svn commit -m "Add multiple files"
15. Adding         file1.txt
16. Adding         file2.txt
17. Adding         file3.txt
18. Transmitting file data ...
19. Committed revision 125.

复制代码

5.3 添加目录

添加目录及其内容：

2. # 创建目录结构
3. $ mkdir -p project/src project/docs project/tests
5. # 在目录中创建文件
6. $ echo "Source code" > project/src/main.c
7. $ echo "Documentation" > project/docs/readme.txt
8. $ echo "Test cases" > project/tests/test.c
10. # 添加整个目录结构
11. $ svn add project
12. A         project
13. A         project/src
14. A         project/src/main.c
15. A         project/docs
16. A         project/docs/readme.txt
17. A         project/tests
18. A         project/tests/test.c
20. # 提交更改
21. $ svn commit -m "Add project directory structure"
22. Adding         project
23. Adding         project/src
24. Adding         project/src/main.c
25. Adding         project/docs
26. Adding         project/docs/readme.txt
27. Adding         project/tests
28. Adding         project/tests/test.c
29. Transmitting file data ...
30. Committed revision 126.

复制代码

5.4 使用通配符添加文件

你可以使用通配符来添加符合特定模式的文件：

2. # 创建多个同类型文件
3. $ touch image1.jpg image2.jpg image3.jpg
4. $ touch document1.pdf document2.pdf
6. # 添加所有JPEG图像
7. $ svn add *.jpg
8. A         image1.jpg
9. A         image2.jpg
10. A         image3.jpg
12. # 添加所有PDF文档
13. $ svn add *.pdf
14. A         document1.pdf
15. A         document2.pdf
17. # 提交更改
18. $ svn commit -m "Add image and document files"
19. Adding         image1.jpg
20. Adding         image2.jpg
21. Adding         image3.jpg
22. Adding         document1.pdf
23. Adding         document2.pdf
24. Transmitting file data ...
25. Committed revision 127.

复制代码

5.5 递归添加文件

递归添加目录及其所有内容：

2. # 创建嵌套目录结构
3. $ mkdir -p project/modules/module1 project/modules/module2
4. $ echo "Module 1 code" > project/modules/module1/code.py
5. $ echo "Module 2 code" > project/modules/module2/code.py
7. # 递归添加目录及其内容
8. $ svn add --depth=infinity project
9. A         project
10. A         project/modules
11. A         project/modules/module1
12. A         project/modules/module1/code.py
13. A         project/modules/module2
14. A         project/modules/module2/code.py
16. # 提交更改
17. $ svn commit -m "Add project with modules recursively"
18. Adding         project
19. Adding         project/modules
20. Adding         project/modules/module1
21. Adding         project/modules/module1/code.py
22. Adding         project/modules/module2
23. Adding         project/modules/module2/code.py
24. Transmitting file data ...
25. Committed revision 128.

复制代码

5.6 添加二进制文件

添加二进制文件（如图片、可执行文件等）需要特殊处理：

2. # 创建二进制文件（这里以图片为例）
3. $ # 假设我们有一个logo.png文件
5. # 添加二进制文件并设置MIME类型
6. $ svn add logo.png
7. A         logo.png
8. $ svn propset svn:mime-type image/png logo.png
9. property 'svn:mime-type' set on 'logo.png'
11. # 提交更改
12. $ svn commit -m "Add logo image"
13. Adding         logo.png
14. Transmitting file data .
15. Committed revision 129.

复制代码

5.7 添加可执行文件

对于需要执行权限的文件，需要设置相应的属性：

2. # 创建一个简单的脚本文件
3. $ echo "#!/bin/bash\necho 'Hello, world!'" > hello.sh
5. # 添加文件并设置执行权限
6. $ svn add hello.sh
7. A         hello.sh
8. $ svn propset svn:executable ON hello.sh
9. property 'svn:executable' set on 'hello.sh'
11. # 提交更改
12. $ svn commit -m "Add executable script"
13. Adding         hello.sh
14. Transmitting file data .
15. Committed revision 130.

复制代码

5.8 添加外部引用

SVN允许你添加外部引用，即引用其他版本库中的目录：

2. # 创建一个目录用于存放外部引用
3. $ mkdir ext_libs
5. # 添加目录到版本控制
6. $ svn add ext_libs
7. A         ext_libs
9. # 设置外部引用属性
10. $ svn propset svn:externals "library https://svn.example.com/libs/library" ext_libs
11. property 'svn:externals' set on 'ext_libs'
13. # 提交更改
14. $ svn commit -m "Add external library reference"
15. Adding         ext_libs
16. Committed revision 131.
18. # 更新工作副本以获取外部引用
19. $ svn update
20. Updating '.':
21. Updating ext_libs:
22. A    ext_libs/library
23. Updated to revision 131.

复制代码

5.9 添加关键字替换

对于某些文件，你可能希望SVN自动替换关键字（如版本号、日期等）：

2. # 创建一个包含关键字的文件
3. $ echo "/*
4. * File: \$Id\$
5. * Revision: \$Revision\$
6. * Date: \$Date\$
7. */" > version_info.h
9. # 添加文件到版本控制
10. $ svn add version_info.h
11. A         version_info.h
13. # 设置关键字替换属性
14. $ svn propset svn:keywords "Id Revision Date" version_info.h
15. property 'svn:keywords' set on 'version_info.h'
17. # 提交更改
18. $ svn commit -m "Add version info file with keyword substitution"
19. Adding         version_info.h
20. Transmitting file data .
21. Committed revision 132.

复制代码

5.10 添加忽略文件

创建和管理忽略文件列表，以避免版本控制不必要的文件：

2. # 创建一个目录
3. $ mkdir temp
5. # 添加目录到版本控制
6. $ svn add temp
7. A         temp
9. # 设置忽略属性
10. $ svn propset svn:ignore "*.tmp
11. *.log
12. *.bak" temp
13. property 'svn:ignore' set on 'temp'
15. # 提交更改
16. $ svn commit -m "Add temp directory with ignore patterns"
17. Adding         temp
18. Committed revision 133.

复制代码

6. SVN最佳实践

为了更有效地使用SVN进行版本控制，以下是一些最佳实践建议：

6.1 有意义的提交信息

每次提交都应提供清晰、有意义的提交信息：

2. # 不好的提交信息
3. $ svn commit -m "fixed some bugs"
5. # 好的提交信息
6. $ svn commit -m "Fix login authentication issue: corrected password validation logic and added error handling for invalid credentials"

复制代码

6.2 频繁提交

经常提交小的更改，而不是偶尔提交大的更改：

2. # 好的做法：完成一个小功能后立即提交
3. $ svn commit -m "Implement user authentication module"
5. # 不好的做法：等待多个功能完成后再提交
6. $ # ...多个功能开发...
7. $ svn commit -m "Implement authentication, user profile and reporting modules"

复制代码

6.3 更新前提交

在更新工作副本之前，先提交你的更改：

2. # 好的做法
3. $ svn commit -m "Complete user interface design"
4. $ svn update
6. # 不好的做法
7. $ svn update
8. # 可能会产生冲突
9. $ svn commit -m "Complete user interface design"

复制代码

6.4 使用分支进行实验性开发

对于实验性或大型功能开发，使用分支：

2. # 创建新分支
3. $ svn copy ^/trunk ^/branches/experimental-feature -m "Create branch for experimental feature"
5. # 切换到分支
6. $ svn switch ^/branches/experimental-feature
8. # 在分支上进行开发
9. # ...开发工作...
11. # 完成后，合并回主干
12. $ svn switch ^/trunk
13. $ svn merge ^/branches/experimental-feature
14. $ svn commit -m "Merge experimental feature to trunk"

复制代码

6.5 定期检查状态

定期使用svn status检查工作副本状态：

2. # 检查工作副本状态
3. $ svn status
5. # 显示所有文件，包括未版本控制的文件
6. $ svn status --no-ignore
8. # 显示详细状态信息
9. $ svn status -v

复制代码

6.6 使用外部依赖管理

对于公共库和依赖项，使用外部引用：

2. # 设置外部引用
3. $ svn propset svn:externals "library https://svn.example.com/libs/library
4. framework https://svn.example.com/frameworks/framework" libs
6. # 更新以获取外部引用
7. $ svn update

复制代码

6.7 定期备份版本库

定期备份SVN版本库以防止数据丢失：

2. # 创建完整的版本库备份
3. $ svnadmin dump /path/to/repository > repository_backup.dump
5. # 或者使用热拷贝
6. $ svnadmin hotcopy /path/to/repository /path/to/backup

复制代码

7. 常见问题与解决方案

7.1 提交时出现”out of date”错误

问题：尝试提交时收到”out of date”错误。

原因：你的工作副本不是最新的，其他人已经提交了更改。

解决方案：

2. # 更新工作副本
3. $ svn update
5. # 如果出现冲突，解决冲突
6. # ...解决冲突...
8. # 然后再次提交
9. $ svn commit -m "Your commit message"

复制代码

7.2 无法添加已经版本控制的文件

问题：尝试添加一个已经在版本控制下的文件。

原因：文件已经被SVN管理。

解决方案：

2. # 检查文件状态
3. $ svn status filename
5. # 如果文件已被删除并重新创建，先恢复它
6. $ svn revert filename
8. # 或者如果文件确实需要重新添加，先删除再添加
9. $ svn delete filename
10. $ svn commit -m "Remove old version of file"
11. $ # 重新创建文件...
12. $ svn add filename
13. $ svn commit -m "Re-add file with new content"

复制代码

7.3 添加文件后没有出现在提交列表中

问题：添加文件后，执行提交操作时文件没有出现在提交列表中。

原因：文件可能没有被正确添加到版本控制。

解决方案：

2. # 检查文件状态
3. $ svn status
5. # 如果文件前面有"?"标记，表示它未被添加
6. $ svn add filename
8. # 再次检查状态，确认文件前面有"A"标记
9. $ svn status
11. # 然后提交
12. $ svn commit -m "Add file"

复制代码

7.4 二进制文件损坏

问题：提交或更新二进制文件后，文件损坏。

原因：没有正确设置文件的MIME类型或SVN将其视为文本文件处理。

解决方案：

2. # 为二进制文件设置正确的MIME类型
3. $ svn propset svn:mime-type application/octet-stream filename
5. # 或者对于特定类型的二进制文件，使用特定的MIME类型
6. $ svn propset svn:mime-type image/png filename.png
7. $ svn propset svn:mime-type application/pdf filename.pdf
9. # 提交属性更改
10. $ svn commit -m "Set correct MIME type for binary file"

复制代码

8. 总结

SVN中的加号标记表示文件已被添加到版本控制但尚未提交。理解这一标记的含义以及如何正确处理新增文件是有效使用SVN的关键。通过遵循本文提供的指南和最佳实践，你可以更加高效地管理项目中的新增文件，确保版本控制流程的顺畅性和可靠性。

记住，良好的版本控制习惯不仅包括正确添加和提交文件，还包括定期更新、使用有意义的提交信息、处理冲突以及遵循团队约定的开发流程。通过掌握这些技能，你将能够充分利用SVN的强大功能，为项目的成功做出贡献。