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)
点击页面右上角的 “Sign in” (登录)按钮,登录你的 GitHub 账号。
点击右上角 + 号,选择 New repository。
填写仓库信息:
Repository name: 比如 test(取个相关的名字)
Description: (可选) 简单描述,如
A Minesweeper game built by me
。Public / Private: 选择 Public (公开),别人才能看到和下载。
Initialize this repository with a README: 取消勾选 (因为我们不放代码,不需要这个)。
其他选项(.gitignore 和 license)都保持为空。
点击 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。
五、复制链接
上传完成后,可直接复制首页链接,分享给别人下载体验。
这里小博送给大家自己喜欢的一句话,“花香蝶自来”。加油!!