1. 准备工作
-
安装 Git
如果尚未安装 Git,请先下载并安装:-
Windows/macOS: Git 官网
-
Linux: 通过包管理器安装(如
sudo apt install git
)
-
-
注册 GitHub 账号
如果没有账号,请先在 GitHub 官网 注册。 -
配置 Git 用户名和邮箱
打开终端(Windows 用 Git Bash ),运行以下命令:git config --global user.name "你的用户名" (随便命名) git config --global user.email "你的邮箱" (随便命名)
2. 在 GitHub 上创建仓库
-
登录 GitHub,点击右上角 "+ New repository"。
-
输入仓库名称(如
my-project
),选择公开(Public)或私有(Private)。 -
勾选 "Initialize this repository with a README"(可选,适合空仓库)。
-
点击 "Create repository"。
3. 将本地文件上传到 GitHub
方法一:通过命令行上传(推荐)
-
打开终端,进入本地项目文件夹:
cd /path/to/your/project
-
初始化 Git 仓库(如果尚未初始化):
git init
-
添加文件到暂存区:
git add . # 添加所有文件 # 或指定文件 git add filename.txt # 添加单个文件
-
提交更改:
git commit -m "提交描述(如:第一次上传)"
-
连接远程仓库(替换为你的仓库URL):
git remote add origin https://github.com/你的用户名/仓库名.git
-
推送文件到 GitHub:
git push -u origin main # 如果分支是 main # 或 git push -u origin master # 旧版默认分支可能是 master
方法二:通过 GitHub Desktop(图形化工具)
-
下载安装 GitHub Desktop。
-
登录 GitHub 账号,选择 "File" → "Add Local Repository" 导入本地文件夹。
-
填写提交信息,点击 "Commit to main"。
-
点击 "Push origin" 上传到 GitHub。
方法三:直接拖拽上传(适合少量文件)
-
在 GitHub 仓库页面,点击 "Add file" → "Upload files"。
-
直接拖拽文件到网页,点击 "Commit changes"。
如果推送不成功检查是否以下原因
-
你在 GitHub 网页上创建仓库时勾选了 "Initialize this repository with a README",导致远程仓库比本地多了一个文件。
-
或者别人向这个仓库提交了代码,而你没有先同步。
强制推送(谨慎使用,会覆盖远程内容)
⚠️ 仅适用于 确定远程内容不重要 的情况(比如刚创建的仓库):
git push -f origin master # -f 表示强制覆盖
注意:如果仓库是多人协作的,强制推送可能会导致其他人的代码丢失!