1. 环境准备Git安装与基础配置第一次用Gitee上传项目文件夹就像搬新家要先准备打包工具一样我们需要先安装Git这个搬运工。我推荐直接从官网下载避免第三方渠道可能带来的版本问题。打开浏览器输入git-scm.com你会看到一个醒目的下载按钮就像超市入口的购物车一样显眼。选择对应操作系统的版本时要注意就像买衣服要选对尺码。Windows用户建议选64位版本Mac用户则要区分Intel芯片和M系列芯片。我去年帮团队新人安装时就有人因为选错版本导致后续操作报错白白浪费半小时。下载完成后双击安装包所有选项保持默认即可特别是勾选Git Bash Here这个选项它能让后续操作方便很多。验证安装是否成功很简单就像测试新买的手机能不能开机。按下WinR输入cmd打开命令提示符输入git --version如果显示版本号比如我电脑上现在是2.41.0就说明安装成功。有个小技巧安装完成后建议重启一次电脑这样系统环境变量才会生效避免后续操作出现git不是内部命令的报错。2. 账号设置你的代码身份证配置Git账号就像办理快递寄件要填寄件人信息否则仓库不知道是谁上传的代码。在命令行执行这两个命令时要注意邮箱最好用注册Gitee时绑定的邮箱这样提交记录才能和账号关联git config --global user.name 你的Gitee用户名 git config --global user.email 你的注册邮箱我见过有新手直接复制网上的命令忘记修改用户名和邮箱结果提交记录显示的都是别人的信息。还有个实用小技巧加上color.uiauto配置能让命令行输出更易读就像给黑白照片上了色git config --global color.ui auto这些配置信息都保存在用户目录下的.gitconfig文件里如果想修改可以直接编辑这个文件或者重新运行配置命令。建议团队开发时统一邮箱后缀方便后期统计提交量。曾经有个项目因为成员邮箱格式不统一统计代码贡献时额外花了半天时间整理数据。3. 项目初始化创建本地仓库在项目文件夹里初始化Git仓库就像给搬家物品贴标签。右键点击项目文件夹选择Git Bash Here这个操作相当于打开了专门为当前文件夹准备的命令行窗口。输入git init命令后你会注意到文件夹里多了个隐藏的.git目录这就是Git的记忆中枢记录所有版本变更。我去年指导实习生时有人不小心删除了这个目录导致整个版本历史丢失只能从头初始化。所以切记不要手动修改.git目录里的内容初始化完成后用git status命令可以查看当前文件状态新文件会显示为红色表示尚未被Git跟踪。有个常见误区很多人以为git init会把子文件夹也初始化实际上每个子文件夹都需要单独初始化。如果你项目里有多个独立模块可以考虑使用Git的submodule功能不过对新手来说建议先从单仓库开始练习。4. 文件添加选择要上传的内容git add .这个命令就像把物品放进搬家纸箱小数点表示添加当前目录所有文件。如果想添加特定文件可以把小数点换成文件名。我建议新手分批次添加文件特别是当项目里有大量测试文件或日志时避免把不必要的文件传上仓库。实际操作中经常会遇到.gitignore文件配置问题。比如前端项目的node_modules文件夹体积大且可以通过package.json重新生成就应该排除上传。在项目根目录创建.gitignore文件里面写上要忽略的文件名或模式node_modules/ *.log .DS_Store上周帮同事排查上传失败问题发现就是因为没有配置.gitignore导致上传了3GB的临时文件把仓库容量撑爆了。记住上传前先用git status确认要添加的文件列表就像搬家前核对物品清单。5. 提交更改打包你的代码快照git commit -m 提交说明这个操作相当于给搬家纸箱贴标签。提交说明要尽量清晰具体比如修复用户登录时的空指针异常就比修复bug好得多。团队开发时我们要求提交说明必须包含JIRA任务编号方便后期追踪。有个实用技巧使用git commit -am可以跳过暂存区直接提交已跟踪文件的修改相当于git add和git commit -m的合体。但要注意这不会添加新建的文件。我见过有人误以为这个命令能提交所有修改结果漏掉了新创建的重要配置文件。如果发现提交说明写错了可以用git commit --amend修改最近一次提交。但要注意已经推送到远程仓库的提交不要修改否则会给团队协作带来麻烦。就像搬家后才发现标签写错如果是自己家还好如果是帮别人搬家就会造成混乱。6. 连接远程仓库建立传输通道在Gitee上创建新仓库时注意不要勾选使用README初始化仓库否则需要先拉取再推送增加新手操作复杂度。创建完成后复制仓库的HTTPS地址然后在本地执行git remote add origin 仓库地址这个origin是远程仓库的默认别名就像给快递公司起个昵称。我建议保持这个默认名称除非你要同时推送到多个远程仓库。测试连接是否成功可以用git remote -v命令它会显示远程仓库的地址。有时候会遇到remote origin already exists错误说明已经配置过远程仓库。这时可以先删除旧配置git remote remove origin再重新添加。去年遇到个特殊情况同事误将仓库地址配成了HTTPS每次推送都要输密码后来改用SSH协议才解决认证问题。7. 推送代码完成上传最后一步git push -u origin master这个命令就像叫快递员来取件-u参数表示设置上游分支以后可以直接用git push简化命令。首次推送建议加上-f参数强制推送但要注意这会覆盖远程仓库的原有内容团队协作时慎用。推送过程中可能会遇到拒绝访问的错误通常是认证问题。Gitee现在默认要求使用个人访问令牌(PAT)代替密码认证。在账号设置-安全设置中生成令牌时记得勾选projects权限并妥善保存令牌因为它只会显示一次。上传成功后刷新Gitee仓库页面就能看到你的项目文件了。建议立即检查文件完整性特别是注意文件大小是否正确。我有次上传Python项目时因为网络问题导致部分文件损坏直到同事拉取代码报错才发现问题。
Gitee项目文件夹上传全流程详解
1. 环境准备Git安装与基础配置第一次用Gitee上传项目文件夹就像搬新家要先准备打包工具一样我们需要先安装Git这个搬运工。我推荐直接从官网下载避免第三方渠道可能带来的版本问题。打开浏览器输入git-scm.com你会看到一个醒目的下载按钮就像超市入口的购物车一样显眼。选择对应操作系统的版本时要注意就像买衣服要选对尺码。Windows用户建议选64位版本Mac用户则要区分Intel芯片和M系列芯片。我去年帮团队新人安装时就有人因为选错版本导致后续操作报错白白浪费半小时。下载完成后双击安装包所有选项保持默认即可特别是勾选Git Bash Here这个选项它能让后续操作方便很多。验证安装是否成功很简单就像测试新买的手机能不能开机。按下WinR输入cmd打开命令提示符输入git --version如果显示版本号比如我电脑上现在是2.41.0就说明安装成功。有个小技巧安装完成后建议重启一次电脑这样系统环境变量才会生效避免后续操作出现git不是内部命令的报错。2. 账号设置你的代码身份证配置Git账号就像办理快递寄件要填寄件人信息否则仓库不知道是谁上传的代码。在命令行执行这两个命令时要注意邮箱最好用注册Gitee时绑定的邮箱这样提交记录才能和账号关联git config --global user.name 你的Gitee用户名 git config --global user.email 你的注册邮箱我见过有新手直接复制网上的命令忘记修改用户名和邮箱结果提交记录显示的都是别人的信息。还有个实用小技巧加上color.uiauto配置能让命令行输出更易读就像给黑白照片上了色git config --global color.ui auto这些配置信息都保存在用户目录下的.gitconfig文件里如果想修改可以直接编辑这个文件或者重新运行配置命令。建议团队开发时统一邮箱后缀方便后期统计提交量。曾经有个项目因为成员邮箱格式不统一统计代码贡献时额外花了半天时间整理数据。3. 项目初始化创建本地仓库在项目文件夹里初始化Git仓库就像给搬家物品贴标签。右键点击项目文件夹选择Git Bash Here这个操作相当于打开了专门为当前文件夹准备的命令行窗口。输入git init命令后你会注意到文件夹里多了个隐藏的.git目录这就是Git的记忆中枢记录所有版本变更。我去年指导实习生时有人不小心删除了这个目录导致整个版本历史丢失只能从头初始化。所以切记不要手动修改.git目录里的内容初始化完成后用git status命令可以查看当前文件状态新文件会显示为红色表示尚未被Git跟踪。有个常见误区很多人以为git init会把子文件夹也初始化实际上每个子文件夹都需要单独初始化。如果你项目里有多个独立模块可以考虑使用Git的submodule功能不过对新手来说建议先从单仓库开始练习。4. 文件添加选择要上传的内容git add .这个命令就像把物品放进搬家纸箱小数点表示添加当前目录所有文件。如果想添加特定文件可以把小数点换成文件名。我建议新手分批次添加文件特别是当项目里有大量测试文件或日志时避免把不必要的文件传上仓库。实际操作中经常会遇到.gitignore文件配置问题。比如前端项目的node_modules文件夹体积大且可以通过package.json重新生成就应该排除上传。在项目根目录创建.gitignore文件里面写上要忽略的文件名或模式node_modules/ *.log .DS_Store上周帮同事排查上传失败问题发现就是因为没有配置.gitignore导致上传了3GB的临时文件把仓库容量撑爆了。记住上传前先用git status确认要添加的文件列表就像搬家前核对物品清单。5. 提交更改打包你的代码快照git commit -m 提交说明这个操作相当于给搬家纸箱贴标签。提交说明要尽量清晰具体比如修复用户登录时的空指针异常就比修复bug好得多。团队开发时我们要求提交说明必须包含JIRA任务编号方便后期追踪。有个实用技巧使用git commit -am可以跳过暂存区直接提交已跟踪文件的修改相当于git add和git commit -m的合体。但要注意这不会添加新建的文件。我见过有人误以为这个命令能提交所有修改结果漏掉了新创建的重要配置文件。如果发现提交说明写错了可以用git commit --amend修改最近一次提交。但要注意已经推送到远程仓库的提交不要修改否则会给团队协作带来麻烦。就像搬家后才发现标签写错如果是自己家还好如果是帮别人搬家就会造成混乱。6. 连接远程仓库建立传输通道在Gitee上创建新仓库时注意不要勾选使用README初始化仓库否则需要先拉取再推送增加新手操作复杂度。创建完成后复制仓库的HTTPS地址然后在本地执行git remote add origin 仓库地址这个origin是远程仓库的默认别名就像给快递公司起个昵称。我建议保持这个默认名称除非你要同时推送到多个远程仓库。测试连接是否成功可以用git remote -v命令它会显示远程仓库的地址。有时候会遇到remote origin already exists错误说明已经配置过远程仓库。这时可以先删除旧配置git remote remove origin再重新添加。去年遇到个特殊情况同事误将仓库地址配成了HTTPS每次推送都要输密码后来改用SSH协议才解决认证问题。7. 推送代码完成上传最后一步git push -u origin master这个命令就像叫快递员来取件-u参数表示设置上游分支以后可以直接用git push简化命令。首次推送建议加上-f参数强制推送但要注意这会覆盖远程仓库的原有内容团队协作时慎用。推送过程中可能会遇到拒绝访问的错误通常是认证问题。Gitee现在默认要求使用个人访问令牌(PAT)代替密码认证。在账号设置-安全设置中生成令牌时记得勾选projects权限并妥善保存令牌因为它只会显示一次。上传成功后刷新Gitee仓库页面就能看到你的项目文件了。建议立即检查文件完整性特别是注意文件大小是否正确。我有次上传Python项目时因为网络问题导致部分文件损坏直到同事拉取代码报错才发现问题。
