使用Git管理代码是现代开发的基础技能。很多新手第一次接触Git时容易被各种命令绕晕，其实只要理清逻辑，上传项目并不复杂。本文将用大白话带你一步步完成从本地项目到远程仓库的上传全过程，避开常见坑点，确保你能一次成功。
安装Git并配置基础信息
首先确保电脑已安装Git。Windows用户可在官网下载exe安装包一路点击下一步，Mac用户推荐用Homebrew直接在终端输入brew install git。安装完成后打开命令行工具，依次输入两行命令设置你的身份标识。这两步非常关键，因为每次提交记录都会永久绑定这些信息。输入git config global user.name你的名字和git config global user.email你的邮箱地址即可。注意邮箱一定要填你注册代码托管平台时使用的真实邮箱，否则会影响后续的协作权限和通知接收。
初始化本地版本库
把你需要上传的项目文件夹准备好，进入该目录。在终端或命令行中执行git init命令。这相当于告诉Git在这个文件夹里开始追踪文件变化。执行后你会看到目录下多了一个隐藏的.git文件夹，这就是本地仓库的核心所在。此时项目里的文件还只是普通的磁盘文件，并没有进入版本控制状态，你可以随时随意删除或移动它们而不会留下历史记录，一切操作都处于自由状态。
添加文件并提交快照
接下来要把文件加入追踪范围。输入git add .命令可以把当前目录下所有新增或修改的文件加入暂存区。如果你只想上传特定文件，可以把点替换成具体的文件名或路径。确认文件就位后，执行git commit -m描述性文字。这条命令会把暂存区的文件打包成一个版本快照，引号里的内容是你本次修改的说明，比如完成首页布局搭建。只有完成提交，更改才算真正落盘保存，这时候你才拥有了一个可回溯的版本节点，可以随时回退到此状态。
关联远程仓库
现在需要把本地仓库和线上的代码托管平台连接起来。去GitHub、Gitee或GitLab新建一个空项目，创建成功后会给你一个仓库访问地址。在本地终端输入git remote add origin刚才复制的地址。origin是远程仓库的默认别名，方便后续调用。如果之前误配过其他地址，可以用git remote remove origin清理后再重新添加。这一步建立的是本地与云端的桥梁，没有它就无法进行网络同步，也是很多人卡住的第一步。
推送代码到云端
桥接完成后就可以执行推送到远端操作了。运行git push -u origin master。这里的-u参数代表设置上游分支，以后只需输入git push就能直接同步。master是传统的默认分支名称，部分新平台可能要求使用main，请根据实际提示调整。如果提示认证失败，通常是因为平台启用了更严格的密码策略。建议提前配置好SSH密钥，或者在推送时按提示输入个人访问令牌。成功推送后终端会显示传输进度和最终的统计信息，证明数据已安全抵达服务器。
常见问题排查与最佳实践
上传过程中最常遇到的是拒绝覆盖提示。这通常发生在远程已有文件且本地未拉取的情况下。遇到这种情况先执行git pull拉取最新代码，系统会自动尝试合并，若有冲突再手动解决文件内的冲突标记，解决完毕后重新提交推送。另外要注意忽略不必要的文件，在项目根目录创建.gitignore文件，在里面写上node_modules或dist这类不需要上传的目录名，能有效避免仓库臃肿和误传敏感配置。定期养成git status查看状态的习惯，能帮你快速定位当前该执行哪条指令。掌握这套流程后，日常迭代代码会变得非常顺畅。
