Git 项目库创建上传从零到一Git 项目从零到一：创建本地仓库并提交代码至远程 Gitee 仓库详解在现代软件开发中

Git 项目从零到一：创建本地仓库并提交代码至远程 Gitee 仓库详解

在现代软件开发中，版本控制系统（Version Control System, VCS）已成为开发者不可或缺的工具。而 Git 作为目前最流行的分布式版本控制系统，以其高效、灵活和强大的分支管理能力，被广泛应用于个人开发与团队协作中。本文将手把手带你完成一个完整的 Git 工作流：从本地初始化项目仓库，到配置用户信息、添加文件、提交变更，再到关联远程 Gitee 仓库并推送代码。整个过程适用于初学者快速上手 Git，并为后续深入学习打下坚实基础。

一、为什么需要 Git？

假设你正在开发一个名为 lesson_zp 的本地项目文件夹。在没有版本控制的情况下：

你无法回退到之前的代码状态；
多人协作时容易覆盖彼此的修改；
无法清晰记录每次修改的内容和原因。

而 Git 就像“月光宝盒”——它能让你随时穿越回任意历史版本，安全地尝试新功能（通过分支），并与他人高效协同工作。

二、准备工作：安装 Git 与注册 Gitee 账号

安装 Git
访问 git-scm.com/ 下载并安装适合你操作系统的 Git 客户端。安装完成后，在终端（Windows 使用 Git Bash，macOS/Linux 使用 Terminal）中输入：
```
git --version
```
若显示版本号（如 git version 2.40.1），说明安装成功。
注册 Gitee 账号
Gitee（码云）是国内知名的代码托管平台，支持 Git 协议。访问 gitee.com 注册账号，并登录。
- 注意：在终端执行git相关操作时一定要在安装之后全部操作重新执行一遍

三、初始化本地 Git 仓库

假设你的项目目录为 lesson_zp，且尚未使用任何版本控制。

步骤 1：进入项目目录

cd /path/to/your/lesson_zp

步骤 2：执行 `git init`

git init

该命令会在当前目录下创建一个隐藏文件夹 .git，这就是 Git 仓库的核心数据库，用于存储所有版本信息、提交历史、分支结构等。

✅ 此时，lesson_zp 已成为一个本地 Git 仓库，具备版本控制能力。

四、配置 Git 用户信息

Git 需要知道是谁在提交代码，因此必须配置用户名和邮箱。这些信息会永久记录在每次提交中。

git config --global user.name "shunwuyu2020"
git config --global user.email "shunwu2001@163.com"

--global 表示全局配置，适用于本机所有项目。
如果只想对当前项目生效，可去掉 --global，在项目根目录下单独设置。

🔍 验证配置是否成功：
git config user.name
git config user.email

五、添加文件到暂存区并提交

Git 的工作流程分为三个区域：

工作区（Working Directory）：你编辑的文件所在位置。
暂存区（Staging Area）：准备提交的快照。
仓库（Repository）：已提交的历史版本。

步骤 1：查看当前状态

git status

你会看到类似 “Untracked files” 的提示，表示有未被跟踪的文件。

步骤 2：将所有修改添加到暂存区

git add .

. 表示当前目录下所有文件（包括子目录）。
也可指定单个文件：git add README.md

步骤 3：提交到本地仓库

git commit -m "第一次提交"

-m 后跟提交说明（commit message），应简洁明了地描述本次变更内容。
提交后，Git 会生成一个唯一的 SHA-1 哈希值作为该版本的 ID。

💡 建议：提交信息使用中文或英文均可，但需保持一致性，避免无意义的“update”、“fix”等。

六、创建远程仓库（Gitee）

这部分代码需要在Gitee网页创建一个git项目库如下图

完成下面信息设置的填写

登录 Gitee，点击右上角「+」→「新建仓库」。
填写仓库名称（如 lesson_zp），选择公开或私有（免费用户可创建私有库）。
不要勾选“使用 README.md 初始化”，因为我们已有本地代码。
点击「创建」，获得远程仓库地址： gitee.com/shunwuyu202…

七、关联本地仓库与远程仓库

使用 git remote add 命令将本地仓库与远程仓库绑定：

git remote add origin https://gitee.com/shunwuyu2020/lesson_zp.git

origin 是远程仓库的默认别名，可自定义（如 gitee），但约定俗成用 origin。
你可以通过 git remote -v 查看已配置的远程地址。

八、推送代码到 Gitee

首次推送需指定远程分支：

git push -u origin master

-u（或 --set-upstream）表示将本地 master 分支与远程 origin/master 关联。
后续只需执行 git push 即可自动推送到关联分支。

⚠️ 注意：如果你使用的是较新版本的 Git（≥2.28），默认主分支可能叫 main 而非 master。可通过以下命令确认：
git branch
若显示 * main，则应使用：
git push -u origin main

推送时的身份验证

Gitee 不再支持直接使用账号密码通过 HTTPS 推送。推荐使用 私人令牌（Personal Access Token） 替代密码：

在 Gitee「设置」→「私人令牌」中创建一个 token（勾选 repo 权限）。
推送时，当提示输入密码，粘贴该 token 即可。

更安全的方式是配置 SSH 密钥，但 HTTPS + Token 对初学者更友好。

九、验证推送结果

回到 Gitee 仓库页面，刷新后应能看到你提交的文件和提交记录。至此，本地项目已成功同步至远程仓库！

十、后续开发工作流建议

日常开发中，推荐遵循以下流程：

修改代码
git add . 添加变更
git commit -m "描述修改" 提交到本地
git pull origin master （多人协作时先拉取最新代码，避免冲突）
git push 推送到远程

🔄 使用 git log 可查看提交历史；git diff 查看未暂存的差异。

十一、常见问题与注意事项

问题	解决方案
`fatal: not a git repository`	未在 Git 仓库目录下执行命令，请先 `cd` 到项目根目录
推送失败：`remote rejected`	远程仓库有更新，先 `git pull` 再推送
忘记配置用户信息	执行 `git config --global user.name/email` 补充
想删除远程关联	`git remote remove origin`

结语

通过本文，你已掌握 Git 项目从零创建、本地提交到远程推送的完整流程。lesson_zp 不再是一个普通的文件夹，而是一个具备完整版本控制能力的智能代码库。无论你是独立开发者还是团队成员，Git 都能为你提供强大的代码管理保障。

记住：每一次有意义的 commit，都是你编程旅程中的一个里程碑。

未来，你可以进一步学习分支管理（git branch）、合并（git merge）、解决冲突、标签（tag）等高级功能，真正发挥 Git 的分布式优势。

现在，打开你的终端，开始你的第一个 Git 项目吧！🚀

Git 项目库创建上传从零到一