当前位置：首页 > news >正文

pycharm 连git 传文件到GitHub

news 2025/9/19 6:40:36

花了3小时搞定了，记录下。

避坑指南就是加黑字体。

整体来说，能用命令行就别用上面的菜单栏按钮，报错不明确。

其他的有问题问元宝。

------------------------------------------------------------------------------------

将 PyCharm 中的代码通过 Git 上传到 GitHub，能很好地备份和分享你的项目。下面是详细步骤和一些常见问题的处理办法。

📋 前期准备

开始之前，请确保完成以下准备工作：

拥有 GitHub 账号：如果你还没有，请先访问 GitHub 官网注册一个
安装 Git：确保你的电脑上已安装 Git。你可以从 Git 官网下载并安装
配置 Git 用户信息（首次使用需要）：打开命令行，执行以下命令来设置全局用户名和邮箱（提交代码时会用到）：
```
git config --global user.name "你的GitHub用户名"git config --global user.email "你的GitHub邮箱"
```
在 GitHub 上创建个人访问令牌（PAT）：由于 GitHub 不再支持仅凭账号密码操作，你需要创建一个 Token：
- 登录 GitHub，进入 Settings -> Developer settings -> Personal access tokens -> Tokens (classic)。
- 点击 Generate new token (classic)，填写备注，选择过期时间，勾选 repo 权限。
- 生成后务必复制并妥善保存这个 Token，关闭页面后将无法再次查看。

⚙️ 配置 PyCharm

准备工作完成后，接下来需要在 PyCharm 中进行一些配置：

配置 Git 路径：
- 在 PyCharm 中，打开 File-> Settings（Windows/Linux）或 PyCharm-> Preferences（macOS）。
- 导航到 Version Control-> Git。
- 在 "Path to Git executable" 中，确保指向你的 Git 可执行文件（通常安装后会自动检测到，你也可以手动指定路径，如 C:\Program Files\Git\bin\git.exe）。
- 点击 Test 测试，成功则会显示 Git 版本号
绑定 GitHub 账号：
- 在 Settings 中，导航到 Version Control-> GitHub。
- 点击 Add account，选择 Log in with Token。
- 粘贴你之前生成的个人访问令牌（PAT），然后点击 OK 完成绑定

🔄 上传代码到 GitHub

配置完成后，就可以开始上传代码了。

以下是流程中“上传代码”环节各步骤的详细操作说明：

在 GitHub 上创建新仓库：
- 登录 GitHub，点击右上角 + -> New repository。
- 填写仓库名称，选择公开（Public）或私有（Private），暂时不要勾选 "Initialize this repository with a README"。
- 点击 Create repository，创建成功后复制仓库的 HTTPS 或 SSH 地址（如 https://github.com/你的用户名/仓库名.git）
在 PyCharm 中初始化本地 Git 仓库：
- 打开你的项目。
- 点击顶部菜单 VCS-> Enable Version Control Integration...。
- 在弹出的对话框中，选择 Git 并点击 OK。这会在你的项目根目录下创建一个隐藏的 .git文件夹
创建 .gitignore 文件（推荐）：
在项目根目录下创建一个名为 .gitignore的文件，内容可以参考以下常见 Python 项目的忽略规则，这可以避免将虚拟环境、缓存文件等无关内容上传：
```
__pycache__/
*.py[cod]
*$py.class
*.so
.Python
env/
venv/
ENV/
env.bak/
venv.bak/
.idea/
.vscode/
*.log
.env
dist/
build/
*.egg-info/
.pytype/
.mypy_cache/
```
添加文件到暂存区 (git add)：
- 在 PyCharm 的项目文件视图中，右键点击项目根目录或你想要添加的文件。
- 选择 Git-> Add
- 或者，在 PyCharm 底部的终端（Terminal）中执行命令：
  git add .
- 注意，这里用终端执行后报错了，搜了下，需要初始化仓库。
提交到本地仓库 (git commit)：
- 点击 PyCharm 顶部菜单 VCS-> Commit（或使用快捷键 Ctrl+K/ Cmd+K）。
- 在弹出的提交窗口中，勾选要提交的文件，在下方的输入框中填写有意义的提交信息（如 "Initial commit"）。
- 点击 Commit 按钮。
- 注意，这里我点了提交后又报错了，直接跳过这一步，继续。
添加远程仓库地址 (git remote add)：
- 点击 PyCharm 顶部菜单 Git-> Manage Remotes...。
- 在弹出的窗口中点击 +号。
- 在 Name 中通常填写 origin（默认的远程仓库别名）。注意，这里是个天坑啊，name我使用的默认的这个origin，填完下面url提交时一直提示网络不行、防火墙、杀毒软件啥的，连不上GitHub，反复尝试了n多方法后，把仓库名改的和GitHub里新建的仓库名一直才搞定。
- 在 URL 中粘贴你之前在 GitHub 上创建好的仓库地址。这里还有个天坑，填完name和url后提交，让输入GitHub的用户名和密码，用户名不是邮箱，是用户名！！！密码不是GitHub登录密码，是前面让你在GitHub里设置的那个token。实际上最后我提交成功也不是在这里输入的，是在下面终端窗口用命令行 git push 时重新输入用户名和token才搞定的。这里从上面菜单栏搞不定的，建议直接用命令行提交，报错更明显。一般就是没初始化仓库、没找到远程分支、把对应报错放元宝-deepseek里，按教学推进就行了。
- 点击 OK 保存
  。
推送到 GitHub (git push)：
- 点击 PyCharm 顶部菜单 Git-> Push（或使用快捷键 Ctrl+Shift+K/ Cmd+Shift+K）。
- 在弹出的推送窗口中，确保远程仓库（如 origin）和要推送的分支（如 main或 master）正确。
- 点击 Push 按钮
  。
- 如果是首次推送，你可能需要在终端中执行以下命令来建立上游跟踪（PyCharm 有时会自动处理）：
  git push -u origin main
  （请根据你的分支名称将 main替换为 master或其他分支名）