日常开发或者个人项目整理过程中，经常需要把本地的代码或文档同步到云端仓库。Git是目前最流行的版本控制工具，学会用它上传文件不仅能安全备份数据，还能方便团队成员之间协作交流。很多新手看到一堆命令行就感到头疼，其实只要理清底层逻辑，操作起来非常直观。下面按照实际工作流，一步步带你完成文件上传的全过程，避开常见误区。
准备工作：安装与基础配置
第一次使用前，得先在电脑上装好Git客户端。前往官方网站下载对应操作系统的安装包，全程点击默认选项安装即可。安装完成后，打开终端或者命令提示符，输入git version确认软件是否生效。接下来必须设置全局身份信息，这一步是为了让每次提交记录都带上你的署名，方便后续追踪。执行git config --global user.name 你的名字，再执行git config --global user.email 你的邮箱地址。这两条命令只需要运行一次，系统会自动保存到你的用户配置文件中。
进入目标文件夹并初始化仓库
找到你要上传的文件所在的本地目录，在文件夹内右键选择打开Git Bash，或者在终端里用cd命令切换路径。如果这是一个全新搭建的项目，需要运行git init来创建本地仓库。这个指令会在当前目录下悄悄生成一个隐藏的.git文件夹，专门用来记录所有历史改动和操作日志。如果你是从代码托管平台克隆下来的现成项目，则跳过此步，直接往下进行。
将文件加入暂存区
Git的上传机制不是直接把文件扔上去，而是采用先暂存后提交的策略。先用git add把想要同步的文件放入暂存区。如果想上传指定文件，直接写明文件名，例如git add readme.md。如果要打包整个文件夹里的所有内容，可以使用git add .，注意最后的点代表当前路径下的所有文件和子目录。执行完毕后终端可能没有明显提示，但内部状态已经更新。输入git status可以随时查看哪些文件被标记为待处理，界面通常会用绿色字体高亮显示。
提交本地更改快照
文件进入暂存区只是预备动作，真正固化版本需要执行git commit。完整命令是git commit -m 具体的说明文字。这里的备注信息务必写得具体一点，比如新增用户注册模块或者优化图片加载速度。加上-m参数能直接在命令行内写完备注，省去调用编辑器的繁琐步骤。提交成功后，终端会返回一串字符哈希值以及文件变动统计，表示本次快照已永久保存。此时改动仅停留在本机，尚未同步至网络。
关联远程仓库并推送上线
最后环节才是把成果推送到云端服务器。首先要把本地仓库和远端地址建立连接，使用git remote add origin 远程仓库的HTTPS或SSH链接。origin是业界通用的简称，后续指令可以直接引用。若远端已有内容且未下拉过，建议先跑一下git pull origin main获取最新版本，防止覆盖他人修改。核对无误后，键入git push -u origin main即可完成最终上传。初次推送若提示认证失败，多数是因为平台启用了双重验证，需改用个人访问令牌替代常规密码。进度条走完刷新页面，新文件便可见了。
常见问题与实战避坑指南
实操阶段难免碰到报错场景。权限拒绝是最常见的情况，请仔细核对仓库地址拼写，确认账号具备读写权限。另一类麻烦源于分支命名差异，如今主流平台默认主干分支统一叫main而非master，遭遇推送拦截时替换指令中的分支名即可解决。此外，编译中间件或包含密钥的配置文件绝对不要入库，在项目根目录建一个.gitignore文本，按行填入后缀名，add命令便会自动过滤它们。遇到推送被拒多半是并发编辑导致，牢记先拉取合并再推送的原则，保持代码基线一致。熟练运用这套流程后，日常同步会变得极其顺畅。坚持写好提交备注，日后排查故障能节省大量精力。建议初学者先在私人演练库反复练习，摸清命令行反馈规律后再投入正式业务，既稳妥又高效。
