Github上传文件操作指南

发布于:2025-09-04 ⋅ 阅读:(17) ⋅ 点赞:(0)

        Github是一个向开发者和技术爱好者分发软件最标准、最专业的方式。如果我们拥有自己的.exe可执行文件,想分享给别人体验,那么将其上传到Github上面,分享下载链接给别人,你的成果将会随时随地被别人看到。这篇文章将带你零起手入门,打造一个属于自己的开源项目。

本文主要简述如何在Github上面上传自己的.exe可执行文件(而不是在Github上上传代码),以及上传时会出现的一些问题和解决方法。

一、连接外网需求

        由于GitHub 是一家美国的公司,它的服务器在海外。在中国大陆,由于复杂的网络环境,部分地区、部分网络服务商(ISP)可能无法直接访问 GitHub,会出现连接超时或速度极慢的情况。所以操作过程需要我们连接外网(vpn)。上传文件或者代码的过程,可以理解为你的电脑要向一个国外的地址发送数据包。如果网络通路不畅,这个操作就会失败。

操作 是否需要连接 GitHub(外网)? 说明
注册账号 需要 第一次访问网站时就需要。
创建仓库 需要 在 GitHub 网页上点击按钮创建,需要网络。
下载代码 需要 无论是 git clone 还是网页下载 ZIP,都需要从服务器获取数据。
上传代码 需要 这是本次问题的核心:git push 命令必须通过网络将数据发送到 GitHub 服务器。
浏览网页 需要 查看仓库、Issue、PR等都需要访问网站。

二、注册 GitHub 账号

确保你的网络通畅之后,

1.打开 GitHub 官网:https://github.com/

2.点击页面右上角的 “Sign up” (注册)按钮。

  • 邮箱:输入你的电子邮箱地址。这个邮箱非常重要,用于登录、接收通知和重置密码。(建议用Google邮箱)

  • 创建密码:设置一个安全的密码。

  • 用户名:为你自己创建一个唯一的用户名。这将成为你个人主页的地址(例如:https://github.com/你的用户名)。如果提示已存在,就换一个。

  • 产品更新:会有一个选项询问你是否愿意接收产品更新和推荐的邮件,根据自己的意愿选择 y (是) 或 n (否)。

  • 完成后,点击 “Verify” (验证),然后按要求完成一个简单的拼图验证码。

  • 验证邮箱:接下来,GitHub 会向你刚才填写的邮箱发送一封包含验证码的邮件。

完成上面的步骤之后,恭喜你,你成功创建了一个GitHub账号。

二、创建一个代码仓库(Repository)

  1. 点击页面右上角的 “Sign in” (登录)按钮,登录你的 GitHub 账号。

  2. 点击右上角 + 号,选择 New repository

  3. 填写仓库信息:

    • Repository name: 比如 test(取个相关的名字)

    • Description: (可选) 简单描述,如 A Minesweeper game built by me

    • Public / Private: 选择 Public (公开),别人才能看到和下载。

    • Initialize this repository with a README取消勾选 (因为我们不放代码,不需要这个)。

    • 其他选项(.gitignore 和 license)都保持为空。

  4. 点击 Create repository

三、创建一个 Release(发行版)并上传.exe文件

1.进入你刚创建好的空仓库页面。

2.点击右侧栏的 Create a new release 按钮。或者点击仓库名称下方的 Releases 标签页,然后点击 Draft a new release。

注意:这里可能会找不到对应的Releases标签页,可以直接在浏览器地址栏输入以下格式的网址,然后回车:

https://github.com/你的用户名/你的仓库名/releases

点击 Create a new release 按钮。

3.写 Release 信息:

  • Tag version: 输入版本号,比如 v1.0.0 (推荐使用这种格式)。
  • Target:选择main(首次使用可能没有该选项选择)
  • Release title: 输入一个标题,比如 My Minesweeper Game v1.0

  • Describe this release: 写一些描述,比如 First playable release of my Minesweeper game. Enjoy!。你可以写点游戏介绍或操作说明。

  • 拖拽你的 .exe 文件到附件区域(Attach binaries by dropping them here or selecting them)。最后,点击 Publish release 按钮。

四、发布

点击 Publish release首次使用可能无法点击

注意Target:选择main(首次使用可能没有该选项选择)

1、为什么会有 master 和 main 的区别?

这只是一个命名惯例的改变,没有功能上的区别。master 是 Git 早期版本的传统默认分支名,而 main 是 GitHub 等平台推广的新默认名称。

2、没有任何选择,通常意味着GitHub认为你的仓库里没有任何有效的、可以用于构建网站的分支。可能是由于仓库没做过任何一次提交,仓库完全是空的导致。这就需要 需要从一个包含了文件(至少有一次commit)的分支来构建网站。

以下是详细的解决步骤:

如果你本地想要上传的项目文件夹里面包含你的 .exe 文件,请在该文件夹打开命令行(Git Bash, CMD 或 PowerShell),然后依次执行以下命令:

1. 初始化本地Git仓库(如果还没做的话)

git init

2. 将所有文件(包括.exe)添加到暂存区

git add .

3. 进行第一次提交

git commit -m "Initial commit: add game files"

 4. 将本地仓库链接到你的GitHub远程仓库(将下面的URL换成你的仓库URL)

git remote add origin https://github.com/你的用户名/你的仓库名.git

 5. 推送提交到GitHub,并创建主分支(这里以推送到'main'分支为例)

 # 将本地主分支重命名为main(如果本地是master,则用 git branch -M master)

git branch -M main 

6、 推送并建立关联

git push -u origin main 

执行完成后,就可以看到,并可选择main。也可以点击 Publish release。

五、复制链接

上传完成后,可直接复制首页链接,分享给别人下载体验。

这里小博送给大家自己喜欢的一句话,“花香蝶自来”。加油!!


网站公告

今日签到

点亮在社区的每一天
去签到