Git+Gitee完整实操：从本地仓库上传到免密推送与分支管理

你有没有过这种经历：项目在本地写了一半，代码越堆越多，电脑一格式化全没了。或者想跟同学、同事协作开发，结果文件传来传去互相覆盖，改到怀疑人生。其实解决方式一直很成熟，就是 Git 加 Gitee 这套组合：Git 管版本，Gitee 管托管，本地写的每一版改动都能稳稳推上去，需要哪个版本随时拉回来。对于个人开发者、学生党、小团队来说，这几乎是上手最快、性价比最高的方案。

这篇就给你捋一遍 Git 本地仓库快速上传 Gitee 的完整流程，从装 Git、配环境、建仓库到推送、免密，再到日常拉取和分支管理，全是我自己踩过坑之后整理出来的实操记录。不管你是刚装好 Git 还不知道怎么用，还是第一次把项目推到 Gitee 上被各种报错劝退，照着做基本都能跑通。

1. 环境准备：Git 安装与基础配置

既然要操作 Git，第一步肯定是把环境装好。很多人卡在这一步是因为安装包下载慢、安完命令不识别、配置完发现用户名邮箱填错了，各种小问题叠在一起就耐心耗尽了。这里我把从下载到验证的完整过程讲透。

1.1 各平台 Git 安装与验证

Windows 用户直接去 Git 官网下载安装包就行，下载时注意选操作系统对应的位数（64位是主流）。安装过程没有特别需要改的选项，唯一建议是“Adjusting your PATH environment”这一步选择“Git from the command line and also from 3rd-party software”，这样 Git 命令可以在 CMD 和 PowerShell 里直接使用，免得后面打开终端发现找不到 git 命令。安装完成后打开 CMD 或 PowerShell，敲一句：

bash复制git --version

能显示 git version 2.x.x.windows.x 之类的版本号，说明安装成功。macOS 用户可以用 Homebrew 装：brew install git，Linux 用户用发行版自带的包管理器，比如 Ubuntu 执行 sudo apt install git，CentOS 执行 sudo yum install git。装完同样跑一下 git --version 验证。

我在给新电脑配环境时习惯顺手把 Git Bash 也打开测一遍，因为后面很多操作在 Git Bash 里执行比 CMD 更顺手，支持的命令更全。这里有两个细节容易踩坑：一是安装时别一路下一步把默认设置全跳过，特别是 PATH 那一项；二是安装完一定要重开终端窗口再用，不然环境变量不会立即生效。

1.2 配置用户名和邮箱：为什么不能省

Git 提交时，每一次 commit 都会记录提交者的名字和邮箱，这个信息挂在提交记录上，团队协作时用来区分谁改的代码。如果本地没配，Git 会默认用操作系统用户名生成一个奇怪的账号，提交记录看起来就不够规范。配置命令如下：

bash复制git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

--global 表示全局生效，也就是这台机器上所有仓库都用这个身份。如果某个特定项目想用不同身份，可以去掉 --global，在该项目目录下单独执行一次。

配置完成后可以用以下命令查看当前配置，确诊无误再继续：

bash复制git config --global --list

我自己的习惯是邮箱一定填 Gitee 注册用的那个，这样提交记录能关联上 Gitee 账号，推送时会显示头像和名字，一眼能认出是谁的提交。这里有个小坑：如果设置完发现之前提交记录里的邮箱不对，不影响后续推送，只是历史提交关联不上。想改历史记录的话操作比较繁琐，建议在第一次提交前就配好。

2. Gitee 仓库创建与本地仓库初始化

环境准备好之后，下一步是理清楚两端的关系。Gitee 是云端托管平台，用来存远程仓库；本地仓库是你在自己电脑上工作的目录。把本地代码推上去之前，需要先在 Gitee 建一个空仓库，再在本地把目录变成一个 Git 仓库。两个仓库之间通过地址建立连接。

2.1 Gitee 创建新仓库：关键选项怎么选

登录 Gitee 官网，进入右上角的“+”号，下拉选择“新建仓库”。这里有几个选项在第一次创建时容易纠结，我把我的选法列出来：

关于开源许可证，很多人纠结选什么。如果你只是想自己存代码，不打算开源，那就不选许可证，别人看到仓库也知道不能随意