环境准备
在开始之前，确保本地已安装 Git 客户端。Windows 用户建议下载 Git Bash，Mac 或 Linux 用户可直接使用终端。
创建远程仓库
登录 Gitee 官网，点击右上角「+」选择「新建仓库」。填写仓库名称与描述，根据需求选择公开或私有权限。勾选「使用 README 文件初始化仓库」后点击创建，随后复制 HTTPS 或 SSH 地址备用。
配置本地环境
打开终端进入项目目录，右键选择「Open Git Bash Here」（Windows）或直接 cd 至目标路径。首先设置全局用户名和邮箱，这是提交记录的身份标识：
git config --global user.name "YourName"
git config --global user.email "[email protected]"
若需验证配置是否生效，可执行以下命令查看当前值：
git config user.name
git config user.email
初始化与提交代码
将项目文件放入本地目录后，初始化为 Git 仓库：
git init
添加所有文件并暂存更改，注意 add 与 . 之间需要空格：
git add .
git commit -m "Initial commit"
关联远程仓库
回到 Gitee 网页，点击「克隆/下载」获取远程地址。在本地终端执行以下命令将远程仓库关联为 origin：
git remote add origin <你的仓库地址>
如果远程仓库已有内容（如 README），为避免冲突，建议先拉取最新状态再推送：
git pull --rebase origin master
注：若仓库为空，此步骤可跳过。
推送代码
首次推送时，使用 -u 参数建立上游分支关联：
git push -u origin master
若使用 SSH 协议且未配置密钥，系统会提示输入账号密码。此时需先生成 SSH 公钥并添加到 Gitee 账户设置中，后续即可免密操作。
推送成功后，刷新 Gitee 页面即可查看已上传的代码。
分支管理（可选）
如需开发新功能，建议创建独立分支：
git checkout -b new-branch
完成修改并提交后，推送该分支：
git push origin new-branch
常见问题排查
- 权限错误：检查远程地址是否正确，确认 SSH 密钥已绑定或 HTTPS 凭证有效。
- 合并冲突：推送前务必先执行
git pull拉取最新代码，手动解决冲突后再重新提交。 - 大文件限制：Gitee 单文件限制 100MB，超过此大小建议使用 Git LFS 进行管理。