本地代码文件夹上传至 GitHub 详细步骤与命令集合

本地代码文件夹上传至 GitHub 详细步骤与命令集合

本文将详细介绍将本地代码文件夹上传至 GitHub 的完整流程，涵盖命令行操作、认证配置及常见错误处理。

一、准备工作

1. 注册/登录 GitHub

访问 https://github.com 并登录账号。

2. 安装 Git

下载地址：https://git-scm.com/ 安装完成后，在终端输入以下命令验证：

git --version

若显示版本号则安装成功。

二、创建远程仓库

1. 登录 GitHub。
2. 点击右上角 ➕ → New repository。
3. 填写信息：
   • Repository name：仓库名（如 my-project）
   • 描述（可选）
   • 选择 Public / Private
   • ❗不要勾选 Add a README file（避免后续冲突）
4. 点击 Create repository。
5. 复制生成的仓库地址，格式为：

   https://github.com/你的用户名/仓库名.git
   

三、本地初始化与推送

假设本地项目路径为 D:\projects\my-project。

1. 进入项目目录

cd D:\projects\my-project

2. 初始化 Git 仓库

git init

成功后会生成隐藏的 .git 文件夹。

3. 添加所有文件

git add .

. 表示当前目录下所有文件。

4. 提交代码

git commit -m "first commit"

5. 绑定远程仓库

将下方地址替换为你的实际仓库地址：

git remote add origin https://github.com/你的用户名/仓库名.git

6. 推送到 GitHub

git branch -M main
git push -u origin main

首次推送时，系统会要求输入用户名和密码。密码处需使用 Token（详见下文）。

四、认证配置（Token）

GitHub 已禁用账号密码登录，需使用 Token。

1. 访问 https://github.com/settings/tokens。
2. 点击 Generate new token (classic)。
3. 勾选 repo 权限，点击生成。
4. 复制生成的 Token（仅显示一次）。
5. 推送时：
   • Username：GitHub 用户名
   • Password：粘贴 Token

五、常见问题与解决方案

1. 推送报错 failed to push some refs

原因：远程仓库有文件，本地无文件。 解决：

git pull origin main --allow-unrelated-histories
git push origin main

2. SSH 权限拒绝 (Permission denied (publickey))

原因：使用了 SSH 协议但未配置密钥。 方案 A（推荐新手）：改用 HTTPS + Token。

git remote remove origin
git remote add origin https://github.com/你的用户名/仓库名.git
git push -u origin main

方案 B（进阶）：配置 SSH Key。

ssh-keygen -t ed25519 -C "[email protected]"
# 将公钥添加到 GitHub Settings -> SSH and GPG keys

3. 连接重置 (Connection was reset)

原因：网络层问题或 SSL 组件异常。 解决：切换 Git SSL 后端。

git config --global http.sslBackend schannel
git push -u origin main

若仍失败，尝试关闭 HTTP/2：

git config --global http.version HTTP/1.1
git push -u origin main

4. 代理设置

如果处于校园网或公司网，可能需要配置代理：

git config --global http.proxy http://127.0.0.1:端口号
git config --global https.proxy http://127.0.0.1:端口号

如需取消代理：

git config --global --unset http.proxy
git config --global --unset https.proxy

六、图形化方式（GitHub Desktop）

如果不习惯命令行，可使用 GitHub Desktop。

1. 下载：https://desktop.github.com/
2. 登录 GitHub。
3. Add → Add Local Repository。
4. Publish Repository。

七、忽略文件

在项目根目录新建 .gitignore 文件，内容示例：

node_modules/
dist/
.idea/
*.log

然后重新提交：

git add .
git commit -m "add gitignore"
git push