将代码上传到 GitHub 需要先在本地进行初始化 Git 仓库，并且创建一个 GitHub 仓库。以下是具体的步骤：

一. 在 GitHub 上创建一个新仓库：

• 登录到 GitHub。
• 点击右上角的加号（+），选择 “New repository”。
• 输入仓库名称和描述，选择是否公开或私有。
• 点击 “Create repository”。

二. 在本地初始化 Git 仓库并提交代码：

• 打开终端（或命令行）。

• 进入你的代码所在的文件夹：

  1	cd /path/to/your/code

• 如果还没有初始化 Git 仓库，运行以下命令：

  1

  git init

• 将所有文件添加到 Git 仓库：

  1

  git add .

• 提交更改：

  1	git commit -m "release:1.0"

三. 连接到 GitHub 仓库：

• 复制你刚刚在 GitHub 创建的新仓库的 URL，形如：

  1	https://github.com/your-username/your-repository.git

• 在本地仓库中将 GitHub 仓库添加为远程仓库：

  1	git remote add origin https://github.com/your-username/your-repository.git

四. 推送代码到 GitHub

• 推送代码到 GitHub 的 main 分支（如果你的 GitHub 仓库默认分支是 master，请相应替换为 master）：

  1	git push -u origin main

• 推送报错

  

这个错误通常发生在您尝试推送到一个分支（如“main”）时，而该分支实际上还没有被创建或提交过。

可以尝试以下步骤来解决这个问题：

1. 确保您有一个初始提交：

   1	git commit -m "Initial commit"

2. 创建“main”分支（如果它还不存在）：

   1	git branch -M main

3. 再次推送代码到远程仓库：

   1	git push -u origin main

从错误信息来看，您的本地分支和远程仓库的分支内容不一致。这个错误是因为远程仓库中的 main 分支已经有内容，而您的本地仓库没有这些内容。因此，Git 阻止您直接推送，以避免覆盖远程内容。

解决方法如下：

1. 先将远程 main 分支的内容拉取下来并合并：

   1	git pull origin main --rebase

2. 再次尝试推送到远程：

   1	git push -u origin main

如果您不介意覆盖远程内容（例如远程仓库是新创建的，没有重要内容），可以使用强制推送，但这要谨慎操作：

1

git push -u origin main --force

请注意，强制推送会覆盖远程的 main 分支内容。

五. 输入 GitHub 账户的用户名和密码

• 如果你是第一次推送代码，Git 会提示你输入 GitHub 的用户名和密码。如果启用了 2FA（双重验证），则需要使用 GitHub 的 token 作为密码。

六. 验证

• 打开你的 GitHub 仓库页面，应该能看到你上传的代码。

七. 每次更改代码后提交

每次更改代码后，可以通过以下步骤将更改提交到 GitHub 上的远程仓库：

1. 查看更改

在提交之前，可以使用以下命令查看哪些文件发生了更改：

1

git status

2. 暂存更改

将更改的文件添加到暂存区（准备提交的区域）。可以选择性地添加文件或一次性添加所有文件。

• 添加单个文件：

  1	git add <file_name>

• 添加所有文件：

  1

  git add .

3. 提交更改

将暂存的更改提交到本地仓库，添加一条描述性的信息，说明更改内容：

1

git commit -m "描述提交内容"

例如：

1

git commit -m "修复了登录页面的错误"

4. 推送到 GitHub

将本地提交推送到 GitHub 上的远程仓库（通常是 origin 远程库的 main 分支，或当前的分支）：

1

git push origin main

如果是在其他分支上，例如 feature-branch，则推送该分支：

1

git push origin feature-branch

5. 简化流程：自动添加和提交

如果变更较小且不需要手动选择文件，可以合并添加和提交步骤：

1

git commit -am "提交说明"

-a 选项会自动添加已跟踪文件的更改并提交，但不会添加新文件。

6. 推送新分支（如果是新分支）

如果是在新建分支上工作，可以使用以下命令创建分支并推送到远程：

1
2

git checkout -b new-branch
git push -u origin new-branch

这样可以将新分支 new-branch 推送到 GitHub，并与远程 new-branch 分支关联。

7. 总结流程

通常提交代码到 GitHub 的完整流程如下：

1
2
3
4

git status                    # 检查更改
git add .                     # 暂存所有更改
git commit -m "提交说明"     # 提交更改
git push origin main          # 推送到远程主分支

这样每次更改代码后，都可以将最新的版本推送到 GitHub。

八. 推送github的tag标签版本(可选)

GitHub 的标签（Tag）功能主要用于标记代码仓库中的特定版本或重要的里程碑。标签通常用于版本发布，例如 v1.0.0 或 v2.1.3。以下是如何使用 Git 和 GitHub 管理标签的指南：

1. 创建标签

在本地仓库中，可以通过以下命令创建一个新的标签：

1

git tag <tag_name>

例如，创建一个名为 v1.0 的标签：

1

git tag v1.0

还可以为标签添加描述，以便了解标签的具体内容：

1

git tag -a <tag_name> -m "Tag message"

例如：

1

git tag -a v1.0 -m "First release version 1.0"

2. 将标签推送到远程仓库

标签创建后，还需要推送到 GitHub 才能在 GitHub 的 Tag 页面上看到它。

推送单个标签：

1

git push origin <tag_name>

例如：

1

git push origin v1.0

推送所有标签：

1

git push origin --tags

3. 在 GitHub 上查看标签

在 GitHub 仓库的主页面中，点击顶部导航栏中的 Tags 选项卡（在 Code 页面内）。这将显示该仓库中的所有标签和相应的版本信息。

4. 删除标签

如果需要删除标签，可以按以下步骤操作：

• 删除本地标签：

  1	git tag -d <tag_name>

• 删除远程标签：

  先删除本地标签，再从远程仓库中删除：

  1	git push origin --delete <tag_name>

例如，删除 v1.0 标签：

1
2

git tag -d v1.0
git push origin --delete v1.0

5. 使用 GitHub 的 Release 页面

标签和发布（Release）通常是配合使用的。在 GitHub 上可以将一个标签发布成一个版本（Release），步骤如下：

1. 在 GitHub 仓库的 Releases 页面，点击 Draft a new release。
2. 在 Tag version 中选择一个已有的标签，或创建一个新标签。
3. 添加标题和描述，上传相应的二进制文件（可选），然后点击 Publish release。

这会创建一个版本发布，与标签关联，方便其他人下载或查看特定版本的代码。

通过这些步骤，您就可以灵活地使用 GitHub 的标签功能了。如果有更多需求，GitHub API 还提供了自动化标签和发布管理的功能。

九. 代码上传到不同的 GitHub 仓库（可选）

• 修改远程仓库的 URL(可选)

如果您希望更改项目推送的 GitHub 仓库（例如，更改为另一个 GitHub 仓库地址），可以按照以下步骤进行：

1. 查看当前的远程仓库 URL：

   1	git remote -v

   这将显示当前关联的远程仓库地址。

2. 修改远程仓库 URL： 使用以下命令更新远程仓库的地址：

   1	git remote set-url origin <new_repository_url>

   例如，将远程仓库更改为新的 GitHub 仓库：

   1	git remote set-url origin https://github.com/username/new-repo.git

3. 推送到新仓库： 完成 URL 修改后，可以正常进行代码提交并推送到新的远程仓库。

   1	git push origin <branch_name>

• 修改文件并强制推送到 GitHub（覆盖远程内容）

如果您希望覆盖远程仓库中的内容，可以使用“强制推送”，但要谨慎操作，因为这会覆盖远程仓库中的历史记录。

1. 按正常流程提交更改：

   1 2	git add . git commit -m "更新描述"

2. 强制推送到远程仓库： 使用 --force 选项强制推送。

   1	git push origin <branch_name> --force

⚠️ 注意：强制推送会覆盖远程仓库中该分支的所有历史记录，建议在确认无误后使用。

• 将项目上传到新的 GitHub 仓库

如果您希望将项目上传到一个全新的 GitHub 仓库，可以按照以下步骤：

1. 在 GitHub 网站上创建一个新仓库，不选择初始化 README 或 .gitignore。
2. 在本地项目中添加新的远程仓库：

   1	git remote add new_origin <new_repository_url>

3. 将代码推送到新的远程仓库：

   1	git push -u new_origin <branch_name>

4. 如果不再需要原仓库，可以删除旧的远程连接：

   1	git remote remove origin

• 更改仓库的分支结构

如果您需要修改默认分支的名称，或将更改推送到其他分支，可以按照以下步骤：

1. 重命名分支（例如，将 master 重命名为 main）：

   1	git branch -M main

2. 推送新的分支到远程仓库：

   1	git push -u origin main

3. 在 GitHub 上设置默认分支：

   • 在 GitHub 仓库中，进入 Settings > Branches，将默认分支更改为 main。

十. PyCharm 中将项目上传到新的 GitHub 仓库(可选)

• 在 GitHub 上创建新仓库

1. 登录到 GitHub，点击右上角的 + 按钮，选择 New repository。
2. 输入新仓库的名称，填写描述（可选），设置可见性（Public 或 Private）。
3. 不要选择 Initialize this repository with a README，这样可以避免冲突。
4. 点击 Create repository，GitHub 会生成一个新的仓库并提供其 URL，稍后会用到。

• 在 PyCharm 中初始化 Git 仓库

如果项目还未使用 Git 进行版本控制，您需要先初始化本地 Git 仓库。

1. 打开 PyCharm 项目。
2. 右键点击项目根目录，选择 Git > Enable Version Control Integration...。
3. 在弹出的窗口中选择 Git，点击 OK。这样项目会被初始化为 Git 仓库。

• 提交初始代码

1. 在项目目录中右键，选择 Git > Commit...。
2. 在弹出的提交窗口中，选择需要提交的文件，填写提交信息（如“Initial commit”）。
3. 点击 Commit 或 Commit and Push。

• 将项目关联到 GitHub 远程仓库

1. 点击顶部菜单栏的 Git > Manage Remotes...。
2. 在弹出的窗口中点击 + 号添加新的远程仓库。
3. 在 Name 字段中输入 origin。
4. 在 URL 字段中粘贴您在 GitHub 上创建的新仓库的 URL。
5. 点击 OK 保存。

• 推送代码到 GitHub 仓库

1. 提交完初始代码并关联了远程仓库后，可以将代码推送到 GitHub。
2. 点击顶部菜单栏的 Git > Push。
3. 在弹出的窗口中，确认推送的分支和远程仓库（通常是 origin 和 main 分支）。
4. 点击 Push，等待推送完成。

• 检查 GitHub 仓库

推送完成后，您可以前往 GitHub，刷新新仓库页面，应该能看到上传的代码。

总结

1. 在 GitHub 上创建一个空的仓库。
2. 在 PyCharm 中启用 Git 版本控制并提交初始代码。
3. 将项目与 GitHub 仓库关联，然后推送代码到新仓库。

通过这些步骤，就可以成功将 PyCharm 项目上传到新的 GitHub 仓库。

附：git常用命令