PyCharm 直接把本地项目上传到 GitHub

PyCharm 直接把本地项目上传到 GitHub

以ubuntu系统为例

1. 初始信息确认

1. 确认电脑上安装了git，终端输入：

   git --version

   如果安装了会输出版本号

2. 确认Git 用户信息已经设置，终端输入：

   git config --global --list

   看有没有这两项：

   user.name=...

   user.email=...

   如果没有，就设置：

   git config --global user.name "xxx xxx"

   git config --global user.email "你的GitHub邮箱"

3. 确认项目已经是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 仓库地址。

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

点 OK。

9. 第一次 Push 到 GitHub

然后在 PyCharm 顶部点：

Git → Push...

或者快捷键：

Ctrl + Shift + K

会弹出 Push 窗口。确认：

本地分支 → 远程分支

通常是：

main -> origin/main

或者

master -> origin/master

然后点：Push。

10. 以后怎么同步

你每次改完代码后：

1. 提交

Git → Commit

2. 推送

Git → Push

或者一步：

Commit and Push

这就相当于你说的"直接同步到 GitHub"。