很多刚接触版本管理的开发者在面对Git上传代码时都会感到无从下手，其实只要掌握核心命令流程，整个过程就会变得非常清晰。Git作为目前最流行的分布式版本控制系统，能够帮助你高效管理项目文件、记录每一次修改痕迹，并在团队协作中避免冲突。本文将用最直白的方式，带你从零开始完成本地代码上传至远程仓库的完整操作，全程避开晦涩的理论，只讲实际能跑通的步骤。
第一步：安装Git并验证环境
上传代码的前提是你的电脑上已经装好了Git客户端。Windows用户可以直接去官网下载对应版本的安装包，一路点击下一步即可完成。macOS用户推荐使用Homebrew终端执行brew install git，或者直接使用Xcode自带的命令行工具。Linux系统通常可以通过包管理器一键安装。安装完成后，打开系统的终端或命令行窗口，输入git version命令。如果屏幕打印出版本号信息，说明环境已经准备就绪，可以进入下一步。
第二步：配置全局用户身份
每次提交代码时，Git都需要记录是谁做的修改。为了不用每次手动填写，建议提前设置好全局的用户名和邮箱。在终端中依次运行git config --global user.name你的用户名和git config --global user.email你的邮箱地址。这里的名字和邮箱会出现在后续的每一次提交记录里，请确保与你注册GitHub或Gitee等平台的账号信息保持一致，否则可能会影响提交统计或触发安全校验。
第三步：初始化本地仓库
找到你要上传的项目文件夹，右键选择Git Bash Here，或者先在终端切换到该目录路径。输入git init命令，系统会在当前目录下生成一个隐藏的.git文件夹，这代表本地仓库已经创建成功。此时你的项目文件虽然还在电脑里，但Git还没有开始跟踪它们的状态。你可以放心地进行后续的添加和提交操作。
第四步：暂存文件并提交修改
这一步是上传前最关键的动作。先运行git add .命令，双点符号代表把目录下所有新增或修改过的文件全部加入暂存区。如果你只想上传特定文件，可以把点换成具体的文件名。确认无误后，执行git commit -m提交备注信息，引号内请填写简洁明确的修改说明，比如修复登录接口报错或新增首页布局。只有完成提交，你的改动才会被Git正式记录在案，这时候才算具备了上传的条件。
第五步：绑定远程仓库地址
在代码托管平台创建好项目后，你会拿到一个远程仓库的链接，通常是HTTPS或SSH格式。回到终端输入git remote add origin刚才复制的链接地址，origin是Git约定的默认远程仓库别名。如果之前绑定过其他地址，可以先用git remote remove origin清理旧配置。这一步相当于给你的本地仓库指明代码最终要推送到的目的地，后续所有操作都会基于这个别名进行。
第六步：推送代码至服务器
一切准备妥当后，只需一条命令就能完成上传。输入git push -u origin master（如果是主分支为main则替换为main）。首次推送加上-u参数会自动建立本地分支与远程分支的追踪关系，以后再次提交更新只需直接运行git push即可。终端会显示传输进度，如果遇到权限提示，请输入绑定的平台账号密码或Personal Access Token。看到All branches are up to date的提示，就说明代码已经成功同步到云端。
常见问题与避坑建议
在实际操作中，很多人会遇到拒绝推送的错误。这通常是因为远程仓库有其他人提交了新内容，导致你的本地版本落后。此时应先执行git pull拉取最新代码，合并后再重新推送。另外，大型文件或敏感配置千万不要直接上传，记得在项目根目录创建.gitignore文件，把临时文件、依赖包和密钥路径写进去，Git就会自动忽略这些内容。保持定期提交的习惯，配合清晰的注释，能让整个开发流程更加顺畅。掌握这套基础操作后，你就能自如地管理自己的项目代码了。
