在 GitHub 建同名、完全空的仓库(不要勾选 README/.gitignore),本地目录用 git init→git add .→git commit→git remote add origin→git push -u origin main 即可一次性推上去。
下面是完整操作(Windows/Mac/Linux 通用):
一、准备工作
-
安装 Git:
终端输入:
1
git --version能显示版本就说明已安装;没有就先装 Git。
-
在 GitHub 建同名空仓库
- 右上角点
+→ New repository - Repository name:和你本地文件夹同名
- 不要勾选:Add a README file、.gitignore、License
- 点 Create repository
-
复制仓库地址(HTTPS 或 SSH),例如:
1
https://github.com/你的用户名/仓库名.git
- 右上角点
二、本地操作
打开终端(Git Bash / Terminal / PowerShell),进入你要上传的本地目录根目录:
1
cd /path/to/你的本地文件夹 # Windows 示例:cd D:\my-project
1. 初始化为 Git 仓库
1
git init
2. 添加所有文件到暂存区
1
git add .
(想忽略某些文件,新建 .gitignore 写规则,比如 node_modules/、*.log)
3. 提交到本地仓库
1
git commit -m "Initial commit: 上传本地全部文件"
4. 关联远程 GitHub 仓库
1
git remote add origin https://github.com/你的用户名/仓库名.git
如果提示 remote origin already exists,先删旧关联:
1
git remote remove origin
再重新执行上面命令。
5. 重命名分支为 main(和 GitHub 默认一致)
1
git branch -M main
6. 推送到 GitHub
1
git push -u origin main
-u:以后直接git push即可,不用每次写origin main- 输入 GitHub 账号密码(或用个人访问令牌),完成。
三、常见报错解决
-
fatal: remote origin already exists
→
git remote remove origin后重新关联。 -
error: src refspec main does not match any
→ 没
add或commit成功,重新执行:1 2
git add . git commit -m "Initial commit"
-
合并冲突(远程有 README 等)
→ 必须保证远程是空仓库;如果已有内容,用:
1
git pull origin main --allow-unrelated-histories解决冲突后再 push。