前言
将本地代码同步到 GitHub 是开发者的基础技能。本文涵盖 Windows、macOS 和 Linux 系统的通用操作流程，无需复杂配置，重点讲解如何安全地将私有或公开仓库代码上传至云端。
一、前期准备
1. 注册并登录 GitHub 账号
若尚未拥有账号，请访问 GitHub 官网进行注册。填写用户名、邮箱及密码并完成验证后，即可登录。后续所有操作均需在已登录状态下进行。
2. 安装 Git 并配置用户信息
Git 是连接本地与远程仓库的核心工具。
- Windows: 下载官方安装包，安装时务必勾选「Add Git to PATH」。
- macOS: 推荐终端执行
brew install git，或从官网下载安装包。 - Linux: Ubuntu/Debian 执行
sudo apt update && sudo apt install git；CentOS/RHEL 执行sudo yum install git。
安装完成后，在终端配置与 GitHub 账号一致的信息：
git config --global user.name "你的 GitHub 用户名"
git config --global user.email "你的 GitHub 注册邮箱@xxx.com"
执行 git config --global --list 可验证配置是否生效。
3. 创建远程仓库
登录后点击右上角「+」选择「New repository」。填写仓库名称（建议英文无空格），描述选填。Visibility 务必选择「Private」（仅自己可见）或「Public」。其他选项如 README、License 可根据需求勾选，通常建议留空以避免冲突。创建成功后，复制页面的 HTTPS 地址（格式：https://github.com/用户名/仓库名.git）。
二、本地仓库初始化
打开终端进入代码根目录，例如：
cd ~/Documents/my-code
使用 ls 或 dir 确认文件存在后，执行以下命令将文件夹转为 Git 仓库：
git init
随后将所有代码添加到暂存区：
git add .
检查状态 git status，确认文件变为绿色。接着提交到本地仓库：
git commit -m "初始化项目，添加核心代码"
提交说明需清晰描述本次变更，便于后续追溯。
三、关联远程并推送
将本地仓库与 GitHub 远程地址绑定：
git remote add origin https://github.com/你的用户名/你的仓库名.git
执行 git remote -v 验证关联。若提示别名已存在，先执行 git remote rm origin 删除旧关联。
首次推送需建立分支关联：
git push -u origin main
若本地主分支为 master，则替换为 master。后续更新只需执行 git push。
