一、准备工作
- 在本地安装 Git(官网下载并安装)
- 注册 Gitee 账号并登录
- 在 Gitee 上创建一个新仓库(点击右上角'+'号 -> 新建仓库)
- 在项目根目录创建一个
.gitignore文件,在里面添加不想要推送到 Git 仓库的文件夹或文件。
二、操作步骤及命令解析
1. 初始化本地仓库(若项目尚未使用 Git 管理)
git init
- 作用:在当前目录初始化一个新的 Git 仓库,创建一个隐藏的
.git文件夹,用于存储版本控制相关信息。
2. 将文件添加到暂存区
git add .
- 作用:将当前目录下所有修改过的文件添加到 Git 暂存区。
- 其他用法:
git add 文件名:添加指定文件git add 文件夹名:添加指定文件夹
3. 提交文件到本地仓库
git commit -m "提交说明"
- 作用:将暂存区的文件提交到本地仓库,并添加提交说明(建议说明清晰描述本次修改内容)。
- 提交说明是必填项,用于记录每次修改的目的。
4. 关联 Gitee 远程仓库
git remote add origin https://gitee.com/你的用户名/仓库名.git
- 作用:将本地仓库与 Gitee 上的远程仓库关联起来。
origin是远程仓库的默认别名,也可以使用其他名称。- 仓库地址可在 Gitee 仓库页面获取(克隆/下载按钮处)。
5. 拉取远程仓库内容(首次推送前建议执行)
git pull origin master --allow-unrelated-histories
- 作用:拉取远程仓库的最新内容到本地,并合并。
master是默认分支名(现在 Gitee 可能默认是main)。--allow-unrelated-histories允许合并两个没有共同历史的仓库(首次关联时使用)。
6. 推送本地仓库内容到 Gitee
git push -u origin master
- 作用:将本地仓库的内容推送到 Gitee 远程仓库。
-u参数用于设置默认推送的远程仓库和分支,后续可直接使用git push。master是要推送的本地分支,需与远程分支名称一致。
7. 输入账号密码(首次推送时)
推送命令执行后,会提示输入 Gitee 的账号和密码:

