本文介绍了将本地代码上传至 GitHub 的完整 Git 操作流程。涵盖环境准备、Git 配置、仓库初始化、文件暂存提交、远程关联及代码推送等关键步骤。通过详细讲解常用命令如 git init、add、commit、push 等，帮助开发者解决版本控制中的基础问题，实现代码备份与分享。
在学习 Linux 或 Python 开发时，经常需要把本地写好的代码上传到 GitHub，方便备份和分享。以下是完整的操作流程。
sudo apt install git -y 安装）https://github.com/user_name/仓库名字.git 为例）DB-GPT-Hub 项目为例）conda activate 环境名字
代码讲解：
环境名字 是你的环境名称(环境名字)，表示环境激活成功cd ~/项目名字
代码讲解：
cd：Linux 系统中切换目录的核心命令~/项目名字：你的本地项目绝对路径（~ 代表当前用户的主目录）git config --global user.name "Your Name"
git config --global user.email "[email protected]"
代码讲解：
git config --global user.name "Your Name"
git config：Git 的配置命令，用于设置 Git 的各种参数--global：全局参数，表示该配置对当前用户的所有 Git 仓库生效（无需每个仓库单独配置）user.name：配置 Git 的提交者姓名"Your Name"：替换为你的自定义姓名（如 "Z666"），必须用英文引号包裹git config --global user.email "[email protected]"
user.email：配置 Git 的提交者邮箱"[email protected]"：替换为你的 GitHub 注册邮箱（必须一致，否则 GitHub 无法识别你的提交）git commit 报错git init
代码讲解：
git init：初始化本地仓库的核心命令.git 文件夹，该文件夹用于存储 Git 的版本控制信息（如提交记录、分支信息等）Initialized empty Git repository in /home/你的文件路径/.git/，表示本地仓库初始化成功git add .
代码讲解：
git add：Git 的暂存命令，用于将文件添加到 Git 的暂存区（相当于'待提交缓冲区'）.：通配符，表示当前目录下的所有文件和文件夹（包括子目录）my-db 仓库警告），不影响基础提交，新手可暂时忽略git commit -m "Initial commit"
代码讲解：
git commit：Git 的提交命令，用于将暂存区的文件提交到本地 Git 仓库-m：指定提交备注的参数，必须跟在 git commit 后面"Initial commit"：提交备注信息，用于描述本次提交的内容（如'初始化项目''修复某个 bug'等），方便后续查看提交历史git remote add origin https://github.com/github 账户名字/仓库名字.git
代码讲解：
git remote add：添加远程仓库关联的命令origin：远程仓库的默认别名（Git 的通用约定，可自定义，但不建议修改）https://github.com/Z666/db.git：替换为你的 GitHub 空仓库地址（可从 GitHub 仓库页面复制，支持 HTTPS 和 SSH 两种格式）git checkout -b main
代码讲解：
git checkout：Git 的分支切换命令-b：新建分支并切换的参数（相当于 git branch main + git checkout main 两步操作的合并）main：当前 Git 的默认主分支名称（早期为 master，现在主流平台已改为 main）Switched to a new branch 'main'，表示分支创建并切换成功git commit -m "Initial commit"
代码讲解：
git commit，本地工作区没有新的修改，因此执行后会提示 nothing to commit, working tree clean（无内容可提交，工作区干净）git push -u origin main
代码讲解：
git push：Git 的推送命令，用于将本地仓库的代码推送到远程仓库-u：全称 --set-upstream，核心作用是建立本地 main 分支与远程 origin/main 分支的关联origin：远程仓库的别名（对应步骤 7 中配置的远程仓库）main：要推送的本地分支名称（对应步骤 8 中创建的主分支）推送成功后，打开你的 GitHub 仓库页面（如 https://github.com/Z6666/db.git），即可看到本地的 DB-GPT-Hub 项目代码已经成功上传，所有文件和目录都完整显示。
git commit 时会报错，只需补充步骤 3 的配置即可git push 时会报错，可通过 git remote rm origin 删除错误关联，再重新执行步骤 7本文的核心流程可归纳为：
所有代码都已详细讲解，新手只需按步骤替换自己的项目路径、用户名、邮箱和仓库地址，即可轻松完成本地代码上传到 GitHub 的操作。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online