PyCharm 直接把本地项目上传到 GitHub
以ubuntu系统为例
1. 初始信息确认
-
确认电脑上安装了git,终端输入:
git --version
如果安装了会输出版本号
-
确认Git 用户信息已经设置,终端输入:
git config --global --list
看有没有这两项:
user.name=...
user.email=...
如果没有,就设置:
git config --global user.name "xxx xxx"
git config --global user.email "你的GitHub邮箱"
-
确认项目已经是Git仓库
在项目根目录终端里输入:
ls -la
如果能看到:
.git
说明已经初始化好了。如果没有,就在 PyCharm 里点:
VCS → Enable Version Control Integration → Git
2.PyCharm 里配置 Git
打开 PyCharm,依次点击下面按钮:
File → Settings → Version Control → Git
- 你会看到:Path to Git executable 栏,
- 一般git可执行文件的路径应该是:/usr/bin/git。
- 然后点右边:Test。
- 如果提示成功(在该路径栏下显示Git版本),就说明 PyCharm 能找到 Git。
3.在 PyCharm 里登录 GitHub
依次点击下面按钮:
File → Settings → Version Control → GitHub
然后点:Add account,推荐选择:Log In via GitHub
它会打开浏览器,让你授权。授权成功后,PyCharm 里就能看到你的 GitHub 账号。注意:电脑要有梯子。
4. 先在 GitHub 网站上建一个空仓库
这一步是在浏览器里做:
- 登录 GitHub 后:右上角 **+ **→ New repository
- 然后填写:
- Repository name:你的仓库名
- Description:可写可不写
- Public / Private:自己选
- 注意 下面这些 都不要勾选:
- Add a README file
- Add .gitignore
- Choose a license
然后点:Create repository。创建一个空仓库,最适合你本地已有项目直接上传。
5. 在 PyCharm 里检查项目改动
回到 PyCharm。如果项目已经启用 Git,通常你会看到:新文件是绿色,改动文件有颜色标记。当然如果没看到,也没关系。
6. 先加 .gitignore(非常重要)
尤其是深度学习项目,千万别把:权重、checkpoints、logs、data、.idea等全部传上去。
在项目根目录创建 .gitignore
在 PyCharm 左侧项目树,右键项目根目录,新建一个文件名为:.gitignore的文件,内容可以先写:
.idea/
.vscode/
pycache /*.pyc
*.pyo
*.pyd
*.pth
*.pt
*.ckpt
*.tar
*.npz
checkpoints/
logs/
results/
runs/
wandb/
tensorboard/
data/
datasets/
具体内容可以根据你自己的项目来。例如你项目里还有这些,也建议加:
pretrained/
output/
save_dir/
7. 在 PyCharm 里做第一次提交
鼠标光标放到主菜单,点:
Git → Commit...
或者快捷键:
Ctrl + K
会弹出提交窗口。在这个窗口里做三件事:
- 勾选要提交的文件
- 确认不要把大文件、权重、数据集选进去
- 在下面填写 commit message,比如:Initial commit
然后先点:Commit 。当然,如果你也想一步到位,可以点:Commit and Push。第一次我更建议先 Commit,再单独 Push,一步一步看得更清楚。
8. 把本地项目关联到 GitHub 仓库
在 PyCharm 里操作,路径一般是:
Git → Manage Remotes
会弹出一个窗口。点击 + 添加一个 remote:
Name:origin
URL: 填你刚才创建的GitHub 仓库地址。
点 OK。
9. 第一次 Push 到 GitHub
然后在 PyCharm 顶部点:
Git → Push...
或者快捷键:
Ctrl + Shift + K
会弹出 Push 窗口。确认:
本地分支 → 远程分支
通常是:
main -> origin/main
或者
master -> origin/master
然后点:Push。
10. 以后怎么同步
你每次改完代码后:
- 提交
Git → Commit
- 推送
Git → Push
或者一步:
Commit and Push
这就相当于你说的"直接同步到 GitHub"。