目录

1. 实训前言（学习痛点引入）
2. Git 安装 + 全局 / 局部双模式配置（拓展局部配置知识点）
3. Gitee 仓库创建规范、权限与开源私有选型细则
4. 项目从初始化到 push 全套指令 + 拓展高频辅助 Git 命令
5. Java 项目完整版.gitignore 编写实操 + 生效规则说明
6. Gitee 私人令牌全流程申请、权限勾选、Windows 凭据清理（高分新增）
7. 五大实操致命报错成因 + 分步修复方案
8. 企业项目 Git 开发规范 + 个人后续进阶学习方案 【配图 1：Gitee 新建仓库页面（3 节末尾插入）】 【配图 2：Git Bash 配置与 config 查询运行截图（2 节末尾插入）】 【配图 3：push 成功终端日志截图（4 节末尾插入）】 【配图 4：.gitignore 完整配置截图（5 节末尾插入）】 【配图 5：Gitee 私人令牌权限勾选页面（6 节末尾插入）】

1. 实训前言

在本学期软件工程与开发工具实训课上，Git+Gitee 是工程化项目管理的核心内容。未接触版本控制工具前，我的课程项目依靠复制文件夹改版本号留存源码，项目初稿、修改1版、修复bug版这类存储方式弊端极大：磁盘冗余文件多、代码错乱无法溯源、更换实训设备需要 U 盘传输源码，一旦误删文件项目直接报废。 跟随课程完成多轮上机实操后，我完整实现本地项目云端托管，过程中踩遍新手高频问题：远端仓库冲突、密码失效无法推送、无用编译文件全上传、远端地址重复绑定等。本文跳出课本基础内容，结合企业实际开发标准补充课本未讲解的实操细节，汇总故障解决方案，既是课程考核学习总结，也可作为新手入门 Git 实操手册。

2.Git 安装 + 全局 / 局部双模式配置

Git 安装选用官方原版安装程序，安装步骤中勾选 Git Bash、Git GUI、环境变量配置选项，安装结束后文件夹右键出现Git Bash Here即安装成功。 Git 身份配置分为全局配置（全电脑项目通用）、局部配置（仅当前单个项目生效），企业多账号开发经常用到局部配置。

bash

运行

#全局配置（推荐学生日常使用，绑定个人Gitee注册信息）
git config --global user.name "李睿"
git config --global user.email "填写自己注册Gitee邮箱"
#查看全局配置
git config --global --list

#局部配置：仅作用当前项目，不加--global
git config user.name "项目专用名称"
git config user.email "项目专属邮箱"

补充小知识点：配置信息保存在用户目录.gitconfig（全局）、项目内.git/config（局部），方便手动修改配置。

3.Gitee 仓库创建规范、权限选型

进入 Gitee 官网新建仓库，几项硬性规范直接规避后续推送异常：

1. 仓库名称必须和本地项目文件夹名称完全一致，大小写保持统一；
2. 项目说明标注：计算机应用专业课程实训项目，SpringBoot 练习源码；
3. 学生实训项目优先选择私有仓库，练习开源项目选用公开仓库；
4. 重中之重：禁止勾选初始化 README、禁止自动生成.gitignore 模板，远端自带文件会造成首次 push 版本不匹配报错。 创建完毕复制 HTTPS 仓库链接备用。

4. 项目初始化推送全指令 + 拓展常用 Git 命令

进入项目根目录打开 Git Bash，标准推送流程：

bash

运行

#初始化本地git仓库，生成隐藏.git版本库文件夹
git init
#添加全部文件至暂存区
git add .
#单文件添加写法：git add Test.java
#提交至本地版本库，规范备注格式：版本+修改内容
git commit -m "V1.0 初始化课程完整项目源码"
#绑定远端仓库
git remote add origin https://gitee.com/xxx/xxx.git
#推送master分支代码
git push origin master

加分拓展常用命令（企业高频）：

bash

运行

git log #查看所有提交日志
git status #查看当前文件变更状态
git remote -v #查看已绑定的远端仓库地址

5.Java 完整版.gitignore 配置与生效规则

项目编译产物、IDE 配置、日志、系统垃圾文件不需要上传仓库，在项目根目录新建.gitignore，写入 Java 项目通用过滤规则：

plaintext

#Maven编译目录
target/
#IDEA相关配置
.idea/
*.iml
*.iws
#日志文件
*.log
#系统文件
.DS_Store
#打包临时文件
*.jar.original

注意：已经提交到远端的文件，新增 ignore 不会自动删除，需要先在本地删除再重新提交推送。

6.Gitee 私人令牌申请 + Windows 凭据清理（CSDN 高分关键新增内容）

Gitee 已经下线账号密码鉴权，push 时密码位置需要填写私人令牌 Token，很多同学保存旧凭据导致一直报错：

1. Gitee→个人设置→安全设置→私人令牌→生成新令牌；
2. 权限勾选：projects (读写项目)、pull_request、issues，其余不用勾选；
3. 复制生成令牌（仅展示一次，丢失需重新创建）；
4. Windows 系统旧密码缓存问题：控制面板→凭据管理器→Windows 凭据，删除 Gitee 缓存记录，再次推送输入账号 + 令牌即可。

7. 五大高频报错完整解决方案

1. fatal: remote origin already exists 远端地址重复绑定：git remote remove origin清空原有绑定，重新绑定仓库地址。
2. Updates were rejected because remote have work 远端存在 README，版本冲突：git pull origin master --allow-unrelated-histories拉取合并后再 push。
3. 输入账号令牌依旧验证失败 令牌权限勾选不全，重新生成令牌补齐项目权限。
4. .gitignore 不生效 文件已经被提交过，ignore 无法管控，删除远端文件重新提交。
5. push 超时连接失败 切换 HTTPS/SSH 两种仓库地址重试，网络波动更换链接。

8. 企业 Git 规范 + 个人进阶学习规划

一、日常开发规范

1. 提交备注标准化：版本号 + 改动内容，杜绝修改代码这类模糊备注；
2. 开发新功能前优先git pull拉取远端最新代码，规避代码覆盖冲突；
3. 无用配置、编译文件统一通过.gitignore 过滤，保持仓库整洁。

二、个人课后进阶计划

课程结束后自主学习 Git 分支开发：master 主分支、dev 开发分支、feature 功能分支，贴近企业多团队协作模式；学习 SSH 密钥免密推送，摆脱每次输入令牌的繁琐操作。