Java项目开发中,Git是最常用的分布式版本控制工具,能够记录代码变更历史、支持多人协作开发、方便回溯问题版本。掌握用Git管理Java项目的基本流程,是Java开发者的必备技能。

一、Git环境准备与配置
首先需要安装Git工具,安装完成后配置全局用户信息,这些信息会作为代码提交的作者信息。
# 配置全局用户名 git config --global user.name "your_name" # 配置全局邮箱 git config --global user.email "your_email@ipipp.com"
如果是Java项目,建议配置.gitignore文件,忽略不需要提交的文件,比如编译产物、依赖目录、IDE配置文件等。
# Java项目常用.gitignore内容 # 编译产物 *.class *.jar *.war *.ear # Maven依赖目录 target/ # Gradle依赖目录 build/ # IDE配置文件 .idea/ *.iml .vscode/
二、初始化本地Git仓库
如果是新建的Java项目,可以在项目根目录初始化Git仓库;如果是已有项目,也可以直接初始化。
# 进入Java项目根目录 cd /path/to/your/java/project # 初始化Git仓库 git init
初始化完成后,项目根目录会生成.git隐藏目录,用于存储版本控制相关的所有数据。
三、代码提交基本流程
Java项目开发过程中,代码提交是最高频的操作,基本流程分为三步:添加文件到暂存区、提交到本地仓库、查看提交历史。
1. 添加文件到暂存区
修改或新增Java代码后,需要先将文件添加到暂存区,暂存区用于临时存放待提交的变更。
# 添加单个Java文件 git add src/main/java/com/example/demo/Test.java # 添加所有变更文件 git add .
2. 提交到本地仓库
将暂存区的文件提交到本地仓库,需要添加清晰的提交信息,说明本次修改的内容。
git commit -m "新增用户登录接口实现"
3. 查看提交历史
可以通过命令查看之前的提交记录,了解代码变更情况。
# 查看完整提交历史 git log # 查看简洁版提交历史 git log --oneline
四、分支管理操作
分支是Git的核心特性,Java项目开发中通常会用分支隔离不同功能的开发,避免互相影响。
1. 创建与切换分支
# 创建新分支 git branch feature_user_login # 切换到新分支 git checkout feature_user_login # 也可以一步完成创建并切换 git checkout -b feature_user_login
2. 合并分支
当某个功能的代码开发完成并测试通过后,可以将分支合并到主分支。
# 切换到主分支 git checkout main # 合并功能分支 git merge feature_user_login
3. 删除分支
分支合并完成后,如果不再需要该分支,可以删除。
# 删除已合并的本地分支 git branch -d feature_user_login
五、远程仓库同步
如果是团队协作开发,还需要将本地仓库和远程仓库(如GitHub、GitLab等)同步,实现代码共享。
1. 关联远程仓库
# 关联远程仓库地址 git remote add origin https://ipipp.com/your_name/java-demo.git
2. 推送本地代码到远程
# 推送本地main分支到远程仓库 git push -u origin main # 后续推送可以直接用 git push
3. 拉取远程最新代码
开始开发前,先拉取远程仓库的最新代码,避免和他人代码冲突。
git pull origin main
六、Java项目Git使用注意事项
- 不要将敏感信息提交到Git仓库,比如数据库密码、接口密钥等,建议用配置文件区分环境,敏感信息放在本地配置中并加入
.gitignore忽略。 - 提交信息尽量清晰具体,不要写“修改代码”“更新”这类模糊的描述,方便后续回溯问题。
- 多人开发同一模块时,提交前先拉取最新代码,解决冲突后再提交,避免覆盖他人代码。
- 重要的版本可以打标签,方便后续发布和回溯。
# 打标签 git tag -a v1.0.0 -m "第一个正式版本" # 推送标签到远程 git push origin v1.0.0