前言
将本地代码同步到 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。
身份验证
推送时会要求验证身份。若开启二次验证（2FA），传统密码方式会失效，建议使用 Personal Access Token (PAT)。
- 登录 GitHub，进入 Settings > Developer settings > Personal access tokens。
- 生成新令牌，勾选
repo权限，有效期建议设为永久。 - 复制生成的令牌，粘贴到终端密码输入框（注意：粘贴时无字符显示，直接回车即可）。
四、常见问题
- fatal: not a git repository: 未执行
git init，请重新初始化。 - failed to push some refs: 远程有文件冲突，执行
git pull origin main --rebase拉取合并后再推送。 - PAT 验证失败: 检查令牌是否过期，确保
repo权限已勾选，且粘贴时未包含多余空格。
五、后续更新
代码修改后，无需重复初始化，按以下步骤操作：
git add .
git commit -m "修改说明"
git push
六、常用命令速查
# 配置
git config --global user.name "用户名"
git config --global user.email "邮箱"
# 初始化
git init
# 暂存与提交
git add .
git commit -m "说明"
# 远程管理
git remote add origin <URL>
git push -u origin main
# 验证
git status
git remote -v
掌握上述流程，即可高效完成本地代码的云端托管。遇到具体报错时，结合终端提示排查即可。
