需完成仓库创建、本地初始化、关联远程地址及首次推送：一、GitHub 创建仓库并获取地址；二、本地 git init 并 git remote add origin 关联；三、git add、commit、branch -M main、push -u origin main；四、README 冲突时先 git pull --rebase；五、可用 GitHub Desktop 图形化操作。
如果您已完成本地项目的开发，希望将其上传至 GitHub 进行版本管理与协作共享，则需完成仓库创建、本地初始化、关联远程地址及首次推送等关键操作。以下是具体执行步骤：
一、在 GitHub 网站创建新仓库
该步骤用于生成远程仓库地址，为后续本地项目关联提供目标位置。需注意仓库名称、可见性设置及是否初始化 README 文件。
1、登录 GitHub 官网（https://github.com），点击右上角“+”号，选择 New repository。
2、在 Repository name 栏输入项目名称，确保名称符合 GitHub 命名规范（仅含字母、数字、连字符和下划线，且不以连字符开头或结尾）。
3、在 Description 栏填写简要说明，可选填；勾选 Add a README file 可自动生成初始 README.md，但若本地已有该文件，建议取消勾选以避免冲突。
4、选择 Public 或 Private 可见性；点击 Create repository 完成创建。
二、本地初始化 Git 仓库并关联远程地址
此步骤将本地项目目录纳入 Git 版本控制，并建立与 GitHub 远程仓库的连接关系，使后续提交可同步至云端。
1、打开终端（macOS/Linux）或 Git Bash（Windows），使用 cd 命令进入您的项目根目录（即包含源代码的文件夹）。
2、执行 git init 初始化本地 Git 仓库，生成 .git 子目录。
3、执行 git remote add origin https://github.com/用户名/仓库名.git，将 GitHub 仓库 URL 添加为名为 origin 的远程地址（请将“用户名”和“仓库名”替换为实际值）。
4、如已存在远程地址，需先运行 git remote remove origin 清除旧配置，再执行添加命令。
三、提交本地文件并推送到 GitHub
该过程将项目文件暂存、提交至本地仓库，并最终推送至 GitHub 远程仓库，完成首次发布。
1、执行 git add . 将当前目录所有未跟踪及已修改文件加入暂存区（也可用 git add 文件名 指定单个文件）。
2、执行 git commit -m "Initial commit" 提交暂存区内容，-m 后引号内为提交信息，建议描述清晰、简洁。
3、执行 git branch -M main 将当前分支重命名为 main（GitHub 新建仓库默认主分支为 main，此步确保分支名一致）。
4、执行 git push -u origin main 将本地 main 分支推送至远程 origin，并设置上游跟踪，此后可直接使用 git push。
四、处理 README 冲突的替代方案
若在 GitHub 创建仓库时误勾选了 Add a README file，会导致远程仓库已含 README.md，而本地也存在同名文件，直接推送将失败。此时需先拉取远程内容再合并。
1、执行 git pull --rebase origin main 获取远程 README 并尝试自动合并。
2、若出现冲突提示，打开本地 README.md，手动编辑解决冲突标记（>>>>>），保存后执行 git add README.md。
3、执行 git rebase --continue 完成变基；再运行 git push -u origin main 推送全部内容。
五、使用 GitHub Desktop 图形化上传
对于不熟悉命令行的用户，GitHub Desktop 提供可视化界面完成仓库创建、提交与推送，降低操作门槛。
1、下载并安装 GitHub Desktop（https://desktop.github.com），启动后使用 GitHub 账号登录。
2、点击 File → Add Local Repository，选择本地项目文件夹；若项目尚未初始化，软件会自动执行 git init。
3、在界面左上角点击 Publish repository，输入仓库名称、描述及可见性，勾选 Keep this code on my computer，点击 Publish repository。
4、软件将自动创建远程仓库、关联地址并推送全部文件；后续修改可通过界面勾选文件、填写提交信息、点击 Commit to main 和 Push origin 完成同步。
