Gitee代码上传与Git基础配置指南

1. Gitee代码上传基础准备

在开始上传代码到Gitee之前，我们需要完成一些基础准备工作。这些步骤看似简单，但往往决定了后续操作能否顺利进行。

1.1 注册Gitee账号

首先需要拥有一个Gitee账号。访问Gitee官网（gitee.com），点击右上角的"注册"按钮。建议使用常用邮箱注册，因为后续的仓库通知、协作邀请等重要信息都会发送到这个邮箱。

注册完成后，建议立即进行邮箱验证。未验证的账号在某些功能上会受到限制，比如无法创建私有仓库。

1.2 安装Git客户端

Git是代码版本管理的核心工具，我们需要在本地安装Git客户端：

• Windows用户：下载Git for Windows（https://gitforwindows.org/）
• Mac用户：可以通过Homebrew安装（brew install git）或直接下载安装包
• Linux用户：使用系统包管理器安装（如Ubuntu的sudo apt-get install git）

安装完成后，在终端/命令行中输入git --version验证是否安装成功。如果看到版本号输出（如git version 2.37.1），说明安装正确。

1.3 配置Git全局信息

安装好Git后，需要配置用户信息，这些信息会记录在每次代码提交中：

git config --global user.name "你的用户名" git config --global user.email "你的邮箱"

这里的用户名建议与Gitee账号保持一致，邮箱必须使用注册Gitee时验证过的邮箱。可以通过git config --list命令查看当前配置。

提示：如果工作中需要使用多个Git账号（如公司账号和个人账号），可以使用--local参数替代--global，在不同仓库中设置不同的用户信息。

2. 创建Gitee仓库

2.1 新建远程仓库

登录Gitee后，点击右上角的"+"按钮，选择"新建仓库"。在创建页面需要填写以下关键信息：

• 仓库名称：建议使用英文，避免特殊字符
• 仓库介绍：简要说明仓库用途
• 公开/私有：选择仓库的可见性
• 初始化仓库：可以选择添加README文件（推荐）、.gitignore模板和开源许可证

对于.gitignore文件，Gitee提供了多种预设模板，根据项目类型选择即可。比如Java项目可以选择Java模板，它会自动忽略.class、.jar等编译输出文件。

2.2 获取仓库地址

仓库创建完成后，在仓库页面可以看到多个访问地址：

• HTTPS地址：如https://gitee.com/username/repo.git
• SSH地址：如[e-mail]:username/repo.git

HTTPS方式每次推送都需要输入账号密码，而SSH方式配置一次密钥后就可以免密操作。对于个人开发项目，推荐使用SSH方式。

3. 本地仓库初始化与配置

3.1 初始化本地仓库

在项目根目录打开终端，执行：

git init

这个命令会在当前目录创建.git子目录，包含Git需要的所有元数据。此时项目还没有被Git跟踪，需要显式添加文件。

3.2 添加文件到暂存区

使用以下命令添加文件：

git add .

这里的.表示添加所有文件。如果只想添加特定文件，可以指定文件名：

git add file1.txt file2.js

注意：在添加文件前，建议先创建.gitignore文件，排除不需要版本控制的文件（如IDE配置文件、编译输出等）。

3.3 提交更改到本地仓库

将暂存区的更改提交到本地仓库：

git commit -m "Initial commit"

提交信息应该清晰描述本次更改的内容。好的提交信息有助于后续代码审查和问题追踪。

4. 关联远程仓库并推送代码

4.1 添加远程仓库地址

将本地仓库与Gitee上的远程仓库关联：

git remote add origin [e-mail]:username/repo.git

这里的origin是远程仓库的别名，可以自定义。使用git remote -v可以查看当前配置的远程仓库。

4.2 推送代码到远程仓库

首次推送需要使用-u参数建立追踪关系：

git push -u origin master

后续推送可以简化为：

git push

如果遇到推送失败，可能是因为远程仓库有本地没有的更改（比如在网页端直接修改了文件）。这时需要先执行git pull合并远程更改，再尝试推送。

5. 常见问题与解决方案

5.1 认证失败问题

使用HTTPS方式推送时可能会遇到认证失败。解决方法：

1. 检查账号密码是否正确
2. 考虑使用SSH方式替代HTTPS
3. 或者配置Gitee的私人令牌（Token）作为密码

5.2 文件大小限制

Gitee对单个文件有大小限制（通常为100MB）。如果遇到大文件问题：

1. 使用git lfs管理大文件
2. 或者将大文件移出版本控制，使用其他方式分发

5.3 分支冲突问题

当多人协作时，可能会遇到分支冲突。解决方法：

1. 先拉取最新代码：git pull
2. 解决冲突后重新提交
3. 使用git mergetool可以辅助解决冲突

6. 进阶操作与最佳实践

6.1 使用分支开发

建议为每个新功能或修复创建独立分支：

git checkout -b feature/new-feature

开发完成后合并到主分支：

git checkout master git merge feature/new-feature

6.2 使用标签管理版本

对于重要里程碑，可以创建标签：

git tag -a v1.0.0 -m "Release version 1.0.0" git push origin v1.0.0

6.3 配置.gitignore文件

一个好的.gitignore文件可以避免不必要的文件进入版本控制。示例：

# IDE .idea/ *.iml # Build artifacts /target/ /build/ /dist/ # Dependencies node_modules/ bower_components/ # Environment .env *.env

6.4 使用Git Hooks自动化流程

可以在.git/hooks目录下添加脚本，实现提交前检查、推送后部署等自动化操作。例如pre-commit脚本可以在提交前运行代码检查。

7. 图形化工具推荐

虽然命令行功能强大，但图形化工具可以提高效率：

• Git GUI：Git自带的图形界面
• SourceTree：免费的Git图形客户端
• GitKraken：功能强大的跨平台Git工具
• VS Code Git插件：编辑器内置的Git支持

对于初学者，建议先掌握基本命令行操作，再根据需要使用图形工具辅助。