Git本地仓库上传Gitee完整指南：从初始化到免密推送

1. 先把概念理顺：Git、Gitee和“上传”到底在做什么

先聊个有意思的事。很多新手第一次接触Git，满脑子想的都是“怎么把代码传到网上”，结果一搜教程，全是git init、git add、git commit、git push这一串命令，照着敲完也不知道自己到底干了什么。出错了更懵，报错信息一堆英文，也不知道该查哪个。

我的建议是，动手之前先用三分钟把这条链路搞清楚，后面所有操作都会变得顺理成章。

Git本身是一个版本管理工具，它管的是你本地文件夹里那一堆文件的每一次修改记录。所谓“本地仓库”，就是经过git init初始化之后、被Git纳管的那个文件夹。每次git commit都会往这个本地仓库里存一个快照，相当于给当前的项目状态拍了一张照片，随时能回退。

Gitee则是一个代码托管平台，你可以把它理解成一个远端备份中心。本地仓库是你自己电脑硬盘上的东西，Gitee仓库是服务器上的东西，两者靠git push把本地提交推上去，靠git pull把远端更新拉下来。

所以“本地仓库上传Gitee”这件事，本质上就三步：本地把代码提交成记录，Gitee创建好一个空仓库，再把本地记录推送到远端。

下面我把每一步拆开讲，包括那些教程里很少告诉你、但实操中一定会踩的坑。

2. 环境准备：Git的安装与初始化配置

2.1 各平台安装Git的方式

装Git这件事本身不难，但很多人在装之前会纠结“该下哪个版本”“要不要装Git Bash”。我的建议很直接：

• Windows用户：去Git官网下载安装包，一路默认下一步就行。安装路径建议保持默认的C:\Program Files\Git，不要改到中文路径下，否则后面一些工具可能不认。安装过程中会问调整PATH环境变量，选“Git from the command line and also from 3rd-party software”，这样在CMD和PowerShell里都能直接敲git命令。
• macOS用户：如果装了Homebrew，一条brew install git搞定；没装的话直接官网下载pkg包安装也可以。
• Linux用户：apt install git（Debian/Ubuntu）或者dnf install git（Fedora/CentOS），都行。

装完之后打开终端（Windows下打开Git Bash），敲git --version，能看到版本号就说明装好了。如果提示git : 无法将“git”项识别为 cmdlet、函数、脚本文件或可运行程序的名称，大概率是环境变量没配好，重新运行安装包，选“修复”或者手动把Git的bin目录加到PATH里。

2.2 提交身份配置：为什么一定要配user.name和user.email

这一步很多人会跳过，结果第一次git commit直接报错，提示Please tell me who you are。

Git每次提交都需要记录“是谁提交的”，这个信息就存在user.name和user.email里。不是注册账号，而是一个身份标识，会写进每一条commit记录里，方便团队协作时知道每行代码是谁改的。

配置命令很简单：

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

这里有个值得注意的细节：邮箱不一定要用Gitee绑定的邮箱，但强烈建议用同一个。因为Gitee可以通过邮箱把你的提交记录关联到账号上，如果配了不存在的邮箱，提交虽然能成功，但Gitee上不会显示你的头像，也无法计入贡献图。后面推送时如果开了账号实名关联，邮箱不一致还可能触发校验提醒。

另外这个配置分三个层级：--global配置所有仓库通用，--local只对当前仓库生效，还有个--system是整台机器生效。如果你在公司电脑上想用个人身份提交代码，可以在某个仓库目录下单独配--local的配置，优先级高于全局配置。

2.3 换行符和文件权限设置

这一步是很多老手容易忽略、但跨平台协作时非常关键的配置。

Windows和Linux/macOS的换行符不一样，Windows是CRLF，Linux/macOS是LF。如果不管，一个文件在不同系统上切换编辑后，Git会把整行判定为改动，git diff看过去全是红的，非常头疼。

建议Windows用户执行：

bash复制git config --global core.autocrlf true

macOS/Linux用户：

bash复制git config --global core.autocrlf input

意思是：Windows下提交时自动把CRLF转成LF，检出时转回CRLF；macOS/Linux下提交时转成LF，检出时不转。这样能避免“一换行就全文件冲突”的尴尬。

还有一句建议顺手执行：

bash复制git config --global core.quotepath false

这句解决的是文件名显示中文变成\346\265\213...这类八进制转义的问题。配置后，git status里能直接看到中文文件名，不用再对着乱码猜半天。

3. 在Gitee上创建远程仓库

3.1 创建仓库时的关键选项

登录Git