本地代码推送至 GitHub 完整流程指南
在学习 Linux 或 Python 开发时,经常需要把本地写好的代码上传到 GitHub,方便备份和分享。以下是完整的操作流程。
一、前期准备
- 已安装 Git(Ubuntu 系统可通过
sudo apt install git -y安装) - 拥有 GitHub 账号,并新建了一个空仓库(本文以
https://github.com/user_name/仓库名字.git为例) - 本地已有需要上传的项目代码(本文以
DB-GPT-Hub项目为例)
二、完整操作流程(逐句代码讲解)
步骤 1:激活项目环境(可选,针对 Conda 环境项目)
conda activate 环境名字
代码讲解:
- 这是针对使用 Conda 管理环境的项目,
环境名字是你的环境名称 - 作用:激活项目对应的 Python 环境,确保后续操作在正确的环境中进行(非 Conda 项目可跳过此步骤)
- 执行后终端提示符前会出现
(环境名字),表示环境激活成功
步骤 2:进入本地项目目录
cd ~/项目名字
代码讲解:
cd:Linux 系统中切换目录的核心命令~/项目名字:你的本地项目绝对路径(~代表当前用户的主目录)- 作用:进入需要上传的项目文件夹,后续所有 Git 操作都在该目录下执行
步骤 3:配置 Git 全局用户信息(关键!避免提交报错)
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 每次提交代码时,都会记录提交者的姓名和邮箱,这是 Git 的必要配置,不配置会导致后续
git commit报错
步骤 4:初始化本地 Git 仓库
git init

