需先在github创建空仓库，再本地初始化git仓库，添加文件并提交，接着关联远程仓库地址，最后推送代码；也可用github desktop图形化完成全流程。
如果您已完成本地代码开发，希望将项目发布到 GitHub 进行版本托管与协作，则需要通过 Git 命令行或 GitHub Desktop 工具完成初始化、提交与推送操作。以下是上传项目的完整流程：
一、创建 GitHub 仓库
在上传代码前，需先在 GitHub 网站上新建一个空仓库，用于接收本地代码推送。该仓库提供唯一的远程地址（HTTPS 或 SSH），是后续关联和同步的基础。
1、登录 GitHub 官网（https://github.com）并进入主界面。
2、点击右上角“+”号，选择 New repository。
3、填写仓库名称（Repository name），可选填写描述（Description）。
4、设置可见性：选择 Public（公开）或 Private（私有）。
5、取消勾选 Initialize this repository with a README（避免远程与本地产生初始冲突）。
6、点击 Create repository 按钮完成创建。
二、初始化本地 Git 仓库
Git 需识别项目根目录为受控仓库，通过 git init 命令生成隐藏的 .git 目录，启用版本追踪能力。
1、打开终端（macOS/Linux）或命令提示符/PowerShell（Windows）。
2、使用 cd 命令切换至您的项目根目录，例如：cd /path/to/your/project。
3、执行命令：git init。
4、终端显示 Initialized empty Git repository in ... 即表示初始化成功。
三、添加文件并提交到本地仓库
Git 默认不自动跟踪文件，需显式告知哪些文件纳入版本管理。暂存（stage）后提交（commit）形成不可变的历史快照。
1、执行命令：git add .（将当前目录所有未追踪文件加入暂存区）。
2、如仅添加特定文件，可使用：git add filename.py README.md。
3、执行提交命令：git commit -m "Initial commit"。
4、引号内为提交信息，建议用英文短语准确描述本次变更内容。
四、关联远程仓库并推送代码
本地仓库需绑定 GitHub 上创建的远程仓库地址，才能通过 git push 将提交历史同步过去。
1、复制 GitHub 仓库页面右侧的 HTTPS URL（形如 https://github.com/username/repo-name.git）或 SSH URL（形如 git@github.com:username/repo-name.git）。
2、在终端中执行：git remote add origin https://github.com/username/repo-name.git。
3、验证远程地址是否正确：git remote -v，应显示 origin 对应的 fetch/push 地址。
4、首次推送使用：git push -u origin main（若默认分支为 main）；若为 master 分支，则改用 git push -u origin master。
五、使用 GitHub Desktop 图形化上传
对于不熟悉命令行的用户，GitHub Desktop 提供可视化操作界面，自动处理初始化、暂存、提交与推送全流程，降低操作门槛。
1、从 desktop.github.com 下载并安装 GitHub Desktop。
2、启动应用，使用 GitHub 账户登录。
3、点击 File → Add Local Repository，选择本地项目文件夹。
4、在右侧变更列表中勾选全部文件，输入提交信息，点击 Commit to main。
5、点击右上角 Publish repository，填写仓库名、描述，选择公开性，点击发布。
