很多初学编程、做项目的朋友，最头疼的不是写代码，而是代码管理：文件改来改去分不清版本、误删代码无法恢复、换电脑项目全部重来、多人协作代码混乱冲突。

而 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. 远程平台新建仓库

1. 登录 Gitee/GitHub，点击右上角 New repository（新建仓库）

2. 填写仓库名称（建议和本地项目名一致，纯英文）

3. 可选填写项目简介，选择 Public（公开）

4. 重点避坑：不要勾选 Initialize this repository with README（避免初始化冲突）

5. 点击创建，生成远程仓库 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 仓库使用规范

1. 每次功能性修改必须提交：不要堆积大量改动一次性提交，方便后续定位问题、版本回退

2. 提交备注清晰规范：拒绝胡乱填写，备注写清「新增功能、修复bug、优化代码」

3. 推送前先拉取：多人协作时，先 git pull 同步远程最新代码，再修改推送，避免代码冲突

4. 敏感文件不提交：密码、密钥、本地配置文件，通过 .gitignore 忽略，禁止上传远程仓库

九、总结

Git 仓库不是复杂的工具，而是开发者的代码安全底座：

本地仓库负责版本记录、离线开发；远程仓库负责备份同步、协作共享。

只要熟练掌握 init / add / commit / pull / push / clone 核心命令，就能彻底告别代码丢失、版本混乱、项目备份难题，适配个人开发、课程作业、团队协作所有场景。