很多初学编程、做项目的朋友，最头疼的不是写代码，而是代码管理：文件改来改去分不清版本、误删代码无法恢复、换电脑项目全部重来、多人协作代码混乱冲突。
而Git 仓库就是解决所有问题的核心工具。
本文不讲晦涩原理，只讲能直接落地、日常必用的 Git 仓库完整流程：什么是 Git 仓库、本地仓库搭建、远程仓库关联、代码提交推送、常见报错避坑，看完就能独立管理自己的所有项目代码。
一、到底什么是 Git 仓库？
通俗理解：Git 仓库就是代码的“云端日记本+时光机”。
它会自动记录项目每一次的代码改动，保存每一个版本，支持随时回溯、对比、备份、多人同步。Git 仓库分为两种，各司其职：
本地仓库：存在自己电脑上，离线可用，负责日常代码编写、版本记录、临时存储
远程仓库：托管在网络平台（GitHub / Gitee / GitLab），负责云端备份、跨设备同步、多人协作开发
核心优势：只要代码提交到 Git 仓库，永远不会丢、随时能回退、随时可同步，是所有开发者的必备基础技能。
二、前置准备：Git 基础配置
首次使用 Git 必须配置用户名和邮箱（仅需配置一次），用于标记代码提交者身份，打开 Git Bash 输入以下命令：
# 配置用户名（自定义，建议用账号昵称） git config --global user.name "你的用户名" # 配置邮箱（注册 Gitee/GitHub 的邮箱） git config --global user.email "你的邮箱"
查看配置是否生效：
git config --global --list
三、本地 Git 仓库：从零创建完整流程
本地仓库是所有代码操作的基础，所有提交、版本回退、分支开发都基于本地仓库完成。
1. 初始化本地仓库
进入你的项目文件夹（右键打开 Git Bash），执行初始化命令：
git init
执行后文件夹会生成隐藏的.git文件夹，这就是本地 Git 仓库核心目录，存储所有版本数据，不要手动删除、修改。
2. 代码暂存（加入暂存区）
新建/修改的文件不会自动被 Git 追踪，需要手动加入暂存区：
# 暂存单个文件 git add 文件名 # 暂存当前所有改动文件（日常最常用） git add .
3. 版本提交（存入本地仓库）
暂存后必须提交，才算真正保存一个完整版本，""内填写本次改动说明：
git commit -m "初始化项目/新增功能/修复bug"
4. 查看版本状态
# 查看当前文件改动状态 git status # 查看所有提交版本记录 git log
至此，本地 Git 仓库搭建完成，后续所有代码改动，重复git add .+git commit即可保存版本。
四、远程 Git 仓库（Gitee/GitHub）搭建+关联
本地仓库仅保存在电脑，为了防止文件丢失、跨设备同步，必须关联远程仓库。新手优先用Gitee（码云），访问速度更快、无需翻墙。
1. 远程平台新建仓库
登录 Gitee/GitHub，点击右上角New repository（新建仓库）
填写仓库名称（建议和本地项目名一致，纯英文）
可选填写项目简介，选择Public（公开）
重点避坑：不要勾选
Initialize this repository with README（避免初始化冲突）点击创建，生成远程仓库 HTTPS 地址
2. 本地关联远程仓库
回到项目 Git Bash，执行关联命令，替换为你自己的远程仓库地址：
# 关联远程仓库，origin是远程仓库默认别名（固定写法） git remote add origin 你的远程仓库地址.git # 查看关联是否成功 git remote -v
若关联错误，可解绑重置：git remote remove origin
3. 本地代码推送到远程仓库
首次推送必须指定主分支，绑定上下游关联：
# 首次推送主分支（main/master 根据仓库分支名选择） git push -u origin main # 后续更新推送，直接简写 git push
五、已有远程仓库？一键克隆到本地
如果是接手别人的项目、换电脑同步代码，无需手动创建仓库，直接克隆远程仓库到本地：
git clone 远程仓库地址.git
克隆后的文件夹自带完整 Git 仓库配置，可直接修改、提交、推送，全程无需额外配置。
六、日常开发高频核心命令（必记）
掌握这一套命令，足以应对 99% 的个人项目开发场景：
# 1. 查看文件改动状态 git status # 2. 暂存所有改动 git add . # 3. 提交版本并备注 git commit -m "本次更新说明" # 4. 拉取远程最新代码（多人协作必用，防止冲突） git pull # 5. 推送本地代码到远程 git push # 6. 查看所有版本记录 git log
七、新手高频报错+解决方案
1. 推送报错：远程仓库存在文件冲突
原因：远程仓库有初始化文件（README），和本地仓库版本不一致
解决方案：先拉取远程代码合并，再推送
git pull --rebase origin main
2. 提示未关联远程仓库
解决方案：重新执行远程关联命令，再推送即可
3. 乱改文件想恢复初始状态
# 放弃本地所有未提交的改动，恢复至上一次提交版本 git checkout .
八、新手必守的 Git 仓库使用规范
每次功能性修改必须提交：不要堆积大量改动一次性提交，方便后续定位问题、版本回退
提交备注清晰规范：拒绝胡乱填写，备注写清「新增功能、修复bug、优化代码」
推送前先拉取：多人协作时，先
git pull同步远程最新代码，再修改推送，避免代码冲突敏感文件不提交：密码、密钥、本地配置文件，通过
.gitignore忽略，禁止上传远程仓库
九、总结
Git 仓库不是复杂的工具，而是开发者的代码安全底座：
本地仓库负责版本记录、离线开发；远程仓库负责备份同步、协作共享。
只要熟练掌握init / add / commit / pull / push / clone核心命令，就能彻底告别代码丢失、版本混乱、项目备份难题，适配个人开发、课程作业、团队协作所有场景。
