SVN 与 Eclipse 集成教程：从入门到精通
目录
- 前言：为什么使用 SVN + Eclipse？
- 准备工作
- 1 安装 SVN 客户端
- 2 安装 Eclipse IDE
- 3 安装 Eclipse SVN 插件 (Subclipse 或 Subversive)
- 核心操作：在 Eclipse 中使用 SVN
- 1 从 SVN 仓库签出项目
- 2 将本地项目共享到 SVN 仓库
- 3 更新 项目
- 4 提交 更改
- 5 解决冲突
- 6 查看历史记录
- 7 比较差异
- 最佳实践与工作流
- 常见问题与解决方案
前言：为什么使用 SVN + Eclipse？
SVN (Subversion) 是一个开源的版本控制系统，用于跟踪文件和目录的变更，它允许多个开发者协同工作,而不会互相覆盖对方的代码。
Eclipse 是一个非常流行的集成开发环境，将 SVN 与 Eclipse 集成，你可以直接在 IDE 中完成所有的版本控制操作，无需切换到命令行行,极大地提高了开发效率。
本教程将教你如何将两者无缝结合。
准备工作
在开始之前,请确保你已经准备好以下软件。
1 安装 SVN 客户端
虽然 Eclipse 插件会自带 SVN 客户端，但为了稳定性和兼容性,强烈建议你单独安装一个。
- 推荐工具：TortoiseSVN (Windows 平台下最流行，提供右键菜单集成)
- Mac/Linux: 通常系统包管理器可以直接安装，
sudo apt-get install subversion(Ubuntu/Debian)。
2 安装 Eclipse IDE
确保你已经安装了 Eclipse，本教程适用于 Eclipse for Java Developers, Eclipse for J2EE Developers 等版本。
3 安装 Eclipse SVN 插件
Eclipse 本身不带 SVN 功能，你需要安装一个插件，主流选择有两个：Subclipse 和 Subversive，两者功能相似，选择其一即可，这里我们以 Subclipse 为例进行讲解。
安装 Subclipse 的步骤：
- 打开 Eclipse，点击菜单栏的
Help->Install New Software...。 - 在弹出的窗口中，点击
Add...按钮。 - 在
Name字段输入Subclipse，在Location字段输入http://subclipse.tigris.org/update_1.10.x(这是 1.10.x 版本的更新站点，如果遇到问题可以尝试http://subclipse.tigris.org/update_1.8.x或http://subclipse.tigris.org/update_1.12.x)。 - 点击
OK，Eclipse 会开始加载可用的软件。 - 在列表中，勾选
Subclipse(以及其依赖项，如SVNKit，通常推荐勾选)。 - 点击
Next，然后仔细阅读并接受许可协议，最后点击Finish。 - 安装完成后，Eclipse 会提示你重启，重启后,插件即可生效。
核心操作：在 Eclipse 中使用 SVN
假设你已经有一个 SVN 仓库地址，http://svn.example.com/project/trunk。
1 从 SVN 仓库签出项目
这是将服务器上的代码下载到本地的第一步。
- 在 Eclipse 的菜单栏中，选择
File->Import...。 - 在弹出的窗口中，展开
SVN文件夹，选择Checkout Projects from SVN，然后点击Next。 - 创建新的仓库位置：
- 在
Repository界面，点击Create new repository location。 - 在
URL字段中，输入你的 SVN 仓库地址。 - 如果你的仓库需要用户名和密码，点击
User authentication，并勾选Validate server certificate(如果需要的话)。 - 点击
Next。
- 在
- 选择要签出的项目：
- Eclipse 会连接到仓库并列出其中的项目和文件夹。
- 选择你想要签出的项目或目录，然后点击
Next。
- 选择目标位置：
- 选择一个本地文件夹来存放你签出的项目，Eclipse 通常会提供一个默认建议。
- 你可以选择
Check out as a project in the workspace（推荐，将项目直接导入到工作区）或Check out into the specified folder（只下载文件）。 - 点击
Finish。
- 等待 Eclipse 完成下载和项目配置，完成后，你的项目就会出现在 Eclipse 的
Package Explorer视图中，并且项目图标上会有一个蓝色的标记S，表示它是一个 SVN 项目。
2 将本地项目共享到 SVN 仓库
如果你有一个已经存在的本地项目，并且想把它放到 SVN 仓库中进行管理。
- 在
Package Explorer中,右键点击你想要共享的项目。 - 选择
Team->Share Project...。 - 选择
SVN，然后点击Next。 - 创建新的仓库位置：如果你还没有配置过仓库，按照 3.1 步骤的第 3 点进行配置，如果已配置，选择
Use existing repository location。 - 选择要上传的模块：
- 点击
Use project name as module name,或者手动输入一个模块名。 - 你可以选择将项目上传到仓库的
trunk、branches或tags目录，对于新项目，通常选择trunk。 - 点击
Next。
- 点击
- 确认信息：检查仓库地址和模块路径是否正确，然后点击
Finish。 - 项目已经被共享，但文件还没有被“添加”到版本控制中，你需要右键点击项目，选择
Team->Add to Version Control，文件会变成红色感叹号,表示已添加但未提交。 - 右键点击项目，选择
Team->Commit...，在弹出的窗口中填写提交信息，然后点击OK,完成第一次提交。
3 更新 项目
在你开始修改代码之前，务必先更新,以确保你获取的是最新的代码。
- 在
Package Explorer中，右键点击 SVN 项目。 - 选择
Team->Update。 - Eclipse 会从服务器拉取最新的更改，如果发生冲突，Eclipse 会立即提示你（见 3.5 节）。
4 提交 更改
当你完成了一些修改,并希望将它们保存到服务器上。
- 修改你的代码。
- 在
Package Explorer中,右键点击项目或单个已修改的文件。 - 选择
Team->Commit...。 - 在弹出的窗口中：
- Uncommitted Changes 列表会显示你修改、添加或删除的文件。
- 在上方的文本框中，必须填写有意义的提交信息，描述你这次修改的内容,这是良好的版本控制习惯。
- 你可以选择只提交部分文件（勾选/取消勾选文件）。
- 点击
OK，你的更改就会被发送到 SVN 服务器。
5 解决冲突
当你在提交前没有更新，或者其他人修改了你正在修改的同一部分代码时,就会发生冲突。
冲突的标志：
- 更新时，文件会变成红色感叹号 。
- 提交时，如果冲突未解决,提交会失败。
解决冲突的步骤：
- 更新：右键冲突文件，
Team->Update，Eclipse 会创建一个包含冲突标记的文件。 - 查看冲突文件：打开冲突的文件，你会看到类似下面的标记：
<<<<<<< .mine // 你的代码 ======= // 服务器上最新的代码 >>>>>>> .r123 // r123 是版本号 - 手动解决：你需要仔细比较
<<<<<<<和>>>>>>>之间的代码，手动决定保留哪一部分，或者如何合并它们,删除这些标记行。 - 标记为已解决：保存文件后，右键点击该文件，选择
Team->Mark as Resolved。 - 提交：再次尝试
Commit,冲突就会被解决并成功提交。
6 查看历史记录
你可以查看某个文件或项目的所有修改历史。
- 在
Package Explorer中,右键点击一个文件或文件夹。 - 选择
Team->Show History。 - 一个新的历史记录视图会打开，显示每次提交的作者、日期、版本号和提交信息。
- 你可以双击某一行来查看该版本的详细信息，或者右键选择
Compare With -> Revision...来比较不同版本之间的差异。
7 比较差异
比较你本地修改和服务器最新版本的差异。
- 在
Package Explorer中,右键点击一个已修改但未提交的文件。 - 选择
Team->Compare With -> Latest from SVN。 - 一个差异视图会打开，左边是你的本地版本，右边是服务器版本，红色背景表示被删除的行，绿色背景表示新增的行,这对于快速查看修改内容非常有帮助。
最佳实践与工作流
- 先更新，后修改：这是最重要的黄金法则，每次开始工作前，养成
Update的习惯。 - 小步快跑，频繁提交：不要等到所有功能都完成了才提交，完成一个小功能或修复一个 bug 就应该提交一次，这样你的代码历史会非常清晰,也便于回滚。
- 写清晰的提交信息：用一句话概括你的修改，"Fix login bug with null password" 或 "Add user profile page UI"。
- 提交前测试：确保你的代码在提交后是能正常工作的，不要把有严重 bug 的代码提交到主干。
- 善用分支：对于新功能开发或 bug 修复，最好从
trunk创建一个分支进行开发，完成后再合并回trunk,这样可以避免影响主线的稳定性。
常见问题与解决方案
Q: 提交时提示 "Aborting commit: '/path/to/file' remains in conflict state"
A: 这说明你尝试提交一个尚未解决的冲突文件，请按照 3.5 节的步骤解决冲突并 Mark as Resolved 后再提交。
Q: 如何忽略某些文件（如 .class, .settings, .project）？
A: 1. 右键点击要忽略的文件或文件夹，2. 选择 Team -> Add to svn:ignore，3. 在弹出的对话框中输入要忽略的文件名或模式（*.class 或 .settings），4. 然后提交这个忽略规则。
Q: 如何删除 SVN 仓库中的文件？
A: 1. 在本地删除文件（右键 -> Delete），2. 提交这次删除操作，Eclipse 会自动将删除操作同步到服务器。
Q: Subclipse 插件安装失败或找不到更新站点？
A: 1. 检查你的网络连接，2. 尝试使用其他更新站点地址（如 http://subclipse.tigris.org/update_1.12.x），3. 如果公司有代理，需要在 Eclipse 的 Window -> Preferences -> General -> Network Connections 中配置代理。
通过本教程，你应该已经掌握了在 Eclipse 中使用 Subclipse 插件进行 SVN 版本控制的基本操作，包括签出、共享、更新、提交、解决冲突和查看历史。
SVN 是一个强大的工具，熟练掌握它将极大地提升你的个人和团队开发效率。“先更新，后修改，勤提交” 是使用 SVN 的核心思想,祝你编码愉快！
