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(内网推荐)

bash 复制代码
git remote add origin http://192.168.3.17:8888/组名/项目名.git

方法二:SSH(需要提前配置 SSH Key)

bash 复制代码
git remote add origin git@192.168.3.17:组名/项目名.git

验证远程地址

bash 复制代码
git remote -v

预期输出

text 复制代码
origin  http://192.168.3.17:8888/组名/项目名.git (fetch)
origin  http://192.168.3.17:8888/组名/项目名.git (push)

四、提交本地代码

bash 复制代码
# 1. 添加所有文件到暂存区
git add .

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

五、推送代码到远程分支

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

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

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

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

bash 复制代码
# 将本地 master 推送到远程 feature‑xxx
git push -u origin master:feature-xxx

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

bash 复制代码
# 1. 拉取远程历史,允许无关联历史合并
git pull origin 分支名 --allow-unrelated-histories

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

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

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

六、解决冲突

  1. 查看冲突文件

    IDEA 文件标红即为冲突文件,命令查看:

bash 复制代码
git status
  1. IDEA 图形化解决冲突

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

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

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

  1. 提交冲突处理结果
bash 复制代码
git add .
git commit -m "Merge remote branch"
git push origin 分支名

七、修改远程仓库地址

bash 复制代码
# 查看当前远程地址
git remote -v

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

示例:补充端口号

bash 复制代码
# 旧: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

标准开发工作流

bash 复制代码
# 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
相关推荐
慧都小项5 小时前
MyEclipse Inline Diff 实用指南:逐处核对 AI 修改再提交
git·ai编程·myeclipse·java 代码审查·ai 代码修改
德育处主任8 小时前
让 Claude Code 在你睡觉时接着干活:tmux、权限策略与验收清单
git·ai编程·命令行
为思念酝酿的痛3 天前
Git基本操作
git·github
wno7044 天前
常用的Git命令清单
大数据·git·elasticsearch
真上帝的左手4 天前
3. 代码管理-Git-进阶
git·源代码管理
YIN_尹4 天前
【git原理与使用】git基本操作及底层原理(二)
大数据·git·elasticsearch
程序员爱德华5 天前
Git 命令
git
Cry丶5 天前
Git Rebase 操作备忘
git·rebase
你叶不叶5 天前
abap git 如何从 gitee上在线拉取数据(上一步已经配置好证书)
git·gitee·sap·abapgit
kuroomi6 天前
Git入门
git·kubernetes