项目上传 on iwmei的博客

本地项目上传github的坑点与正确姿势

Mon, 16 Mar 2026 00:00:00 +0000

本地项目上传github的坑点与正确姿势

首先，无论是什么IDE或者编辑器（VS、VScode、Pycharm、Idea、Clion等等），统统不要先在本地创建仓库。

一些坑点

要先绑定github远程仓库，可能出现各种奇怪的问题；
git创建的本地仓库，分支名字是 master ，而github是 main ，直接上传会导致不同分支，不好看；
如果是使用IDE内的版本管理操作的，写完项目再创建仓库，添加文件是会出现困难，重新加 .gitignore 太麻烦了，还可能有各种报错；
仓库间文件不统一，即使使用了 git pull 也还是会报各种错误；
可能因为各种权限问题导致被拒绝push。

建议的正确姿势

进入github主页，点击 New 创建同名的仓库；
1

https://github.com/
- 点击左上角的绿色按钮，按照提示填即可。
创建完毕后，cd到项目存放地，使用 git clone 命令把仓库克隆过来；
1

git clone https://github.com/yourname/yourdepository
- 请在预存放项目的地方打开终端，执行上面的link，后面的仓库地址可以直接从仓库页面下的浏览器链接栏里面复制。
将你要上传的所有文件全部复制进clone下来的文件夹里面；
- 注意，超过100MB的文件无法上传github；
- 注意使用AI添加一个 .gitignore 文件，把有的没的的路径都放进去。
1 2 3 4 5 6 7 8

__pycache__/ *.pyc .env venv/ .idea/ .vscode/ dist/ build/

在终端中依次执行以下命令：

1
2
3


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

后续的操作就转移到这个项目目录下进行即可，在IDE中图形化操作即可。

总结

请下次写项目前，先创建仓库别直接开写好吗 /smile