Git 项目配置与推送完整指南

Git 项目配置与推送完整指南

适用场景：从 GitLab 下载 ZIP 包后，在 IDEA 中配置 Git 并推送到远程仓库

文档版本：v1.0｜更新时间：2026‑08‑18

一、前置准备

确认信息

• GitLab 仓库 Clone 地址
• GitLab 用户名和密码 / Access Token
• 目标分支名称

GitLab 地址格式

协议	地址格式	示例
HTTPS	http://IP:端口/组名/项目名.git	http://192.168.3.21:8888/project/ahuo.git
SSH	git@IP:组名/项目名.git	git@192.168.3.21:project/ahuo.git

二、IDEA 中初始化 Git 仓库

1. 打开项目

   File → Open → 选择项目根目录（pom.xml 所在目录）

2. 启用 Git 集成

   VCS → Enable Version Control Integration

   选择 Git → OK

提示：菜单直接显示 Git，代表已启用，跳过本步骤。

1. 验证 .git 文件夹

• 项目根目录存在隐藏文件夹 .git
• IDEA 文件出现红 / 绿 / 蓝版本控制颜色标记

三、关联远程仓库

方法一：HTTPS（内网推荐）

git remote add origin http://192.168.3.17:8888/组名/项目名.git

方法二：SSH（需要提前配置 SSH Key）

git remote add origin git@192.168.3.17:组名/项目名.git

验证远程地址

git remote -v

预期输出

origin  http://192.168.3.17:8888/组名/项目名.git (fetch)
origin  http://192.168.3.17:8888/组名/项目名.git (push)

四、提交本地代码

# 1. 添加所有文件到暂存区
git add .

# 2. 提交到本地仓库
git commit -m "Initial commit from ZIP"

五、推送代码到远程分支

场景一：推送到已存在的远程分支

# -u 推送并建立本地与远程分支关联
git push -u origin 分支名

# 示例：推送 feature‑zhangry 分支
git push -u origin feature-zhangry

场景二：本地分支名与远程分支不一致

# 将本地 master 推送到远程 feature‑xxx
git push -u origin master:feature-xxx

场景三：远程分支已有内容，推送被拒绝

# 1. 拉取远程历史，允许无关联历史合并
git pull origin 分支名 --allow-unrelated-histories

# 2. IDEA 手动解决冲突文件

# 3. 标记冲突解决并提交
git add .
git commit -m "Merge remote changes"

# 4. 重新推送
git push origin 分支名

六、解决冲突

1. 查看冲突文件

   IDEA 文件标红即为冲突文件，命令查看：

git status

1. IDEA 图形化解决冲突

   双击冲突文件唤起冲突窗口

面板说明：Local(本地)｜Remote(远程)｜Result(最终结果)

点击箭头选择保留内容，全部处理完成点击 Apply

1. 提交冲突处理结果

git add .
git commit -m "Merge remote branch"
git push origin 分支名

七、修改远程仓库地址

# 查看当前远程地址
git remote -v

# 修改远程 origin 地址
git remote set-url origin 新地址

示例：补充端口号

# 旧：http://192.168.3.17/hdjn/spider.git
# 新：http://192.168.3.17:8888/hdjn/spider.git
git remote set-url origin http://192.168.3.17:8888/hdjn/spider.git

八、日常开发操作

常用命令速查

操作	命令
查看工作区状态	git status
查看本地分支	git branch
切换已有分支	git checkout 分支名
创建并切换新分支	git checkout -b 新分支名
添加全部修改	git add .
本地提交	git commit -m "说明"
推送到远程	git push
拉取远程最新	git pull
查看最近 10 条日志	git log --oneline -10

标准开发工作流

# 1. 开发前拉取最新代码
git pull

# 2. 修改业务代码
# 3. 提交变更
git add .
git commit -m "feat: xxx功能完成"

# 4. 推送远程仓库
git push

九、常见问题与解决方案

问题	根因	解决方案
Could not connect to server	端口号缺失 / 错误	地址补全端口，例如 :8888
Permission denied (publickey)	SSH 密钥未配置	改用 HTTPS 方式 或 配置 SSH Key
failed to push	远程存在本地没有的提交记录	git pull --allow-unrelated-histories
Merge conflict	同一文件双方同时修改	IDEA 图形化解决冲突后提交推送
IDEA 不显示 Git 文件颜色状态	未开启版本控制集成	VCS → Enable Version Control → Git

十、推送前检查清单

推送远程前逐项确认：

• 项目根目录存在 .git 隐藏文件夹
• git remote -v 打印的远程地址正确
• git status 当前处于目标工作分支
• 变更已执行 git add + git commit
• GitLab 远程分支已预先创建
• 账号具备仓库推送权限，密码 / AccessToken 有效

附录：Access Token 创建步骤

推送报密码错误时，HTTPS 密码框使用 AccessToken 代替账号密码

1. 浏览器访问内网 GitLab：http://192.168.3.17:8888
2. 右上角头像 → Preferences → Access Tokens
3. Token 名称填写：git-push
4. 过期时间设置远期（例如一年）
5. 权限勾选：write_repository
6. 点击 Create personal access token
7. 立刻复制 Token，页面关闭后无法再次查看
8. IDEA / 终端推送弹窗，密码输入框粘贴该 Token