完整教程：如何将本地文件上传至Github？【详细解释】
<style>pre { white-space: pre !important; word-wrap: normal !important; overflow-x: auto !important; display: block !important; font-family: "Consolas", "Monaco", "Courier New", monospace !important; font-size: 14px !important; line-height: 1.6 !important; padding: 16px !important; margin: 16px 0 !important; background-color: rgba(248, 248, 248, 1) !important; border: 1px solid rgba(225, 228, 232, 1) !important; border-radius: 6px !important; tab-size: 4 !important; -moz-tab-size: 4 !important; max-width: 100% !important; box-sizing: border-box !important }code { font-family: "Consolas", "Monaco", "Courier New", monospace !important; font-size: 14px !important; white-space: pre !important; word-wrap: normal !important; word-break: normal !important; overflow-wrap: normal !important; display: inline !important; background: rgba(0, 0, 0, 0) !important; border: none !important; padding: 0 !important; margin: 0 !important; line-height: inherit !important }
pre code { background: rgba(0, 0, 0, 0) !important; border: 0 !important; border-radius: 0 !important; display: block !important; line-height: 1.6 !important; margin: 0 !important; max-width: none !important; overflow: visible !important; padding: 0 !important; white-space: pre !important; word-wrap: normal !important; word-break: normal !important; color: inherit !important }
.token.comment, .token.prolog, .token.doctype, .token.cdata { color: rgba(112, 128, 144, 1) !important; font-style: italic !important }
.token.punctuation { color: rgba(153, 153, 153, 1) !important }
.token.atrule, .token.attr-value, .token.keyword { color: rgba(0, 119, 170, 1) !important; font-weight: bold !important }
.token.function, .token.class-name { color: rgba(221, 74, 104, 1) !important; font-weight: bold !important }
.token.selector, .token.attr-name, .token.string, .token.char, .token.builtin, .token.inserted { color: rgba(102, 153, 0, 1) !important }
.token.property, .token.tag, .token.boolean, .token.number, .token.constant, .token.symbol, .token.deleted { color: rgba(153, 0, 85, 1) !important }
.cnblogs-markdown pre, .cnblogs-post-body pre { white-space: pre !important; word-wrap: normal !important; overflow-x: auto !important; background-color: rgba(248, 248, 248, 1) !important; border: 1px solid rgba(225, 228, 232, 1) !important; border-radius: 6px !important; padding: 16px !important; margin: 16px 0 !important }
pre, pre, pre { white-space: pre !important; word-wrap: normal !important; overflow-x: auto !important }</style>
<div class="htmledit_views atom-one-dark" id="content_views"><div><p id="main-toc" name="tableOfContents"><strong>目录</strong></p><p id="%E6%96%87%E7%AB%A0%E7%9B%AE%E5%BD%95-toc" name="tableOfContents" style="margin-left: 80px">文章目录</p><p id="%E5%89%8D%E8%A8%80-toc" name="tableOfContents" style="margin-left: 0">前言</p><p id="%E4%B8%80%E3%80%81%E6%96%B0%E5%BB%BA%E4%BB%A3%E7%A0%81%E4%BB%93%E5%BA%93%E4%BB%A5Github%E4%B8%BA%E4%BE%8B-toc" name="tableOfContents" style="margin-left: 0">一、新建代码仓库以Github为例</p><p id="%E4%BA%8C%E3%80%81%20%E6%96%B9%E6%B3%95%E4%B8%80%EF%BC%9A%E4%BD%BF%E7%94%A8Git%E5%B0%86%E6%9C%AC%E5%9C%B0%E6%96%87%E4%BB%B6%E4%B8%8A%E4%BC%A0%E8%87%B3Github-toc" name="tableOfContents" style="margin-left: 0">二、 方法一：使用Git将本地文件上传至Github</p><p id="%E4%B8%89%E3%80%81%E6%96%B9%E6%B3%95%E4%BA%8C%EF%BC%9A%E4%BD%BF%E7%94%A8GitHub%20Desktop%20%E4%B8%8A%E4%BC%A0-toc" name="tableOfContents" style="margin-left: 0">三、方法二：使用GitHub Desktop 上传</p><p id="%E5%9B%9B%E3%80%81%E6%96%B9%E6%B3%95%E4%B8%89%EF%BC%9A%E7%BD%91%E9%A1%B5%E7%AB%AF%E7%9B%B4%E6%8E%A5%E4%B8%8A%E4%BC%A0-toc" name="tableOfContents" style="margin-left: 0">四、方法三：网页端直接上传</p><p id="%E6%80%BB%E7%BB%93-toc" name="tableOfContents" style="margin-left: 0">总结</p><hr id="hr-toc" name="tableOfContents"><p></p></div><hr><h2 id="%E5%89%8D%E8%A8%80" name="%E5%89%8D%E8%A8%80">前言</h2><p>本文适用新手第一次接触Git和GitHub但不知道怎么上传文件，相关概念不在这多介绍。你只需要清楚Git是一个版本控制工具。Github是托管仓库能上传你的代码。</p><p></p><h2 id="%E4%B8%80%E3%80%81%E6%96%B0%E5%BB%BA%E4%BB%A3%E7%A0%81%E4%BB%93%E5%BA%93%E4%BB%A5Github%E4%B8%BA%E4%BE%8B" name="%E4%B8%80%E3%80%81%E6%96%B0%E5%BB%BA%E4%BB%A3%E7%A0%81%E4%BB%93%E5%BA%93%E4%BB%A5Github%E4%B8%BA%E4%BE%8B">一、新建代码仓库以Github为例</h2><p></p><p>代码仓库有GitHub和Gitee，前者是国外的托管平台后者是国内的，可以根据你的需求创建。</p><p>1.登录Github，新建一个代码存储库。</p><p><img alt="" height="616" src="https://i-blog.csdnimg.cn/direct/0979fc2cf3a04eaa8778e133aac01b76.png" width="1919"></p><p>2.创建代码存储库</p><ul><li><p><strong>.gitignore 文件</strong>：用于指定无需纳入版本控制的文件或目录。例如项目编译产生的缓存文件、依赖包、日志等，动辄占用数 GB 空间且无需共享，通过此文件可精准排除这些内容，避免仓库体积膨胀，同时保持代码库的整洁性。</p></li><li><p>README 文件：作为项目的 “说明书”，会直接展示在仓库首页，是用户了解项目的第一入口。其内容应清晰说明项目的功能用途、核心特性、安装步骤、使用方法等关键信息。一份优质的 README 能快速让他人理解项目价值，降低使用门槛。</p></li></ul><p><img alt="" height="829" src="https://i-blog.csdnimg.cn/direct/0d4665bdaf63432da51cb372be828780.png" width="1913"></p><p>3.代码仓库创建好了，我们需要拿到这个链接，这个通常是我们需要的“<span style="color: rgba(254, 44, 36, 1)">仓库地址</span>”。</p><p><img alt="" height="769" src="https://i-blog.csdnimg.cn/direct/b07b2c06839c491ea399599f48c4c932.png" width="1920"></p><p>有了仓库后，我们可以将本地文件上传至 GitHub，以下为你介绍 3 种方法，涵盖网页端、Git 命令行及 GitHub Desktop 工具，并标注了每种方法的适用范围，你可根据自身需求选择：</p><h2 id="%E4%BA%8C%E3%80%81%20%E6%96%B9%E6%B3%95%E4%B8%80%EF%BC%9A%E4%BD%BF%E7%94%A8Git%E5%B0%86%E6%9C%AC%E5%9C%B0%E6%96%87%E4%BB%B6%E4%B8%8A%E4%BC%A0%E8%87%B3Github" name="%E4%BA%8C%E3%80%81%20%E6%96%B9%E6%B3%95%E4%B8%80%EF%BC%9A%E4%BD%BF%E7%94%A8Git%E5%B0%86%E6%9C%AC%E5%9C%B0%E6%96%87%E4%BB%B6%E4%B8%8A%E4%BC%A0%E8%87%B3Github">二、 方法一：使用Git将本地文件上传至Github</h2><blockquote><p>Git 命令行上传（推荐：频繁开发、大量文件、复杂项目）</p></blockquote><p>安装Git就不介绍了，网上找个教程装好了继续看。</p><p>1.打开本地项目的文件夹，这里我新建了一个“Gitpush”里面放了一个c文件和一个截图演示需要上传的文件。</p><p><img alt="" height="567" src="https://i-blog.csdnimg.cn/direct/37d0a11f4e1243d29d096952225e06e8.png" width="929"></p><p>2.资源管理器地址栏输入 “cmd”，回车打开命令提示符。</p><p><img alt="" height="254" src="https://i-blog.csdnimg.cn/direct/acad17a7981540cf8e8928369e45c100.png" width="935"></p><p>3.Git初始化，在命令提示符中输入<span style="color: rgba(254, 44, 36, 1)"> git init 输入之后会创建一个</span>.git文件夹里面存放着git的操作数据</p>
<pre style="white-space: pre !important; word-wrap: normal !important; overflow-x: auto !important"><code class="language-bash">git init# 生成 .git 目录，初始化仓库</code></pre>
<p><img alt="" height="442" src="https://i-blog.csdnimg.cn/direct/03d965a6fee04e08b5ee94b0d6f50438.png" width="1522"></p><p>4.关联远程仓库（粘贴之前提到的仓库地址）HTTPS 地址（每次推送需验证身份）</p>
<pre style="white-space: pre !important; word-wrap: normal !important; overflow-x: auto !important"><code class="language-bash">git remote add origin https://github.com/你的用户名/仓库名.git</code></pre>
<p><img alt="" height="393" src="https://i-blog.csdnimg.cn/direct/e683f391adc34da7a995e4a3d3dd3839.png" width="1040"></p><p>验证关联是否成功：git remote -v（输出 origin 对应的地址即成功）。</p><p><img alt="" height="84" src="https://i-blog.csdnimg.cn/direct/1faaf33f183b48a28c095b0d0bbda82a.png" width="752"></p><p>5.上传文件前要将文件<span style="color: rgba(254, 44, 36, 1)">暂存，这个暂存就是标记你要上传的文件。</span></p>
<pre style="white-space: pre !important; word-wrap: normal !important; overflow-x: auto !important"><code class="language-bash">git add 文件名1 文件名2# 上传指定文件
# 或上传所有文件（推荐，忽略 .gitignore 中指定的内容）
git add .</code></pre>
<p>6.提交到本地仓库（填写提交说明，便于追溯）</p>
<pre style="white-space: pre !important; word-wrap: normal !important; overflow-x: auto !important"><code class="language-bash">git commit -m "提交说明：如「上传项目源码、配置文件」"</code></pre>
<p><img alt="" height="134" src="https://i-blog.csdnimg.cn/direct/dcf3a64f89b046889e9e971c0a0b9ed6.png" width="593"></p><p>7.拉取远程仓库最新内容（避免冲突，首次上传必做）：</p>
<pre style="white-space: pre !important; word-wrap: normal !important; overflow-x: auto !important"><code class="language-bash">git pull origin main --allow-unrelated-histories</code></pre>
<blockquote><p>说明：main 是 GitHub 默认分支名，若你的分支名是 master，替换为 git pull origin master --allow-unrelated-histories；</p></blockquote><p><img alt="" height="258" src="https://i-blog.csdnimg.cn/direct/51d5fb3373724067bf8dd3182b1e1649.png" width="965"></p><p>如果遇到这个，直接按下esc，然后shift+： 输入q！ 就可以退出了。</p><p><img alt="" height="590" src="https://i-blog.csdnimg.cn/direct/3994ebf92fdc4f52938b2729f6d7db49.png" width="674"></p><p>同步成功</p><p><img alt="" height="147" src="https://i-blog.csdnimg.cn/direct/b177fa671ac24b49b393108cbad72363.png" width="669"></p><p>8.推送到远程仓库：</p><ul><li>首次推送（需绑定分支，后续可直接用 git push）：</li></ul><p><code>-u</code> 是 <code>--set-upstream</code> 的缩写，核心作用是<strong>为本地分支绑定对应的远程分支</strong></p>
<pre style="white-space: pre !important; word-wrap: normal !important; overflow-x: auto !important"><code class="language-bash">git push -u origin main# 分支名替换为你的实际分支（如 master）</code></pre>
<ul><li>后续推送（已绑定分支）：</li></ul>
<pre style="white-space: pre !important; word-wrap: normal !important; overflow-x: auto !important"><code class="language-bash">git push</code></pre>
<p>如果报错<span style="color: rgba(254, 44, 36, 1)">error: failed to push some refs</span>，请看我另一篇文章</p><p><img alt="" height="72" src="https://i-blog.csdnimg.cn/direct/b756018193904340a74b1ce845976032.png" width="845"></p><p><span class="link-card-box" contenteditable="false"><span class="link-title">git推送操作时报错error: failed to push some refs</span><span class="link-link"><img class="link-link-icon" src="https://csdnimg.cn/release/blog_editor_html/release2.4.4/ckeditor/plugins/CsdnLink/icons/icon-default.png?t=P9T8">https://blog.csdn.net/ZYXKN/article/details/154538699?spm=1001.2014.3001.5501</span></span>首次推送时他会要求你登录确认身份。点击蓝色按钮用浏览器验证就行。</p><p><img alt="" height="363" src="https://i-blog.csdnimg.cn/direct/1ba7077c18c045f5b6bd2d024c179d98.png" width="420"></p><p>推送成功。</p><p><img alt="" height="219" src="https://i-blog.csdnimg.cn/direct/d9d8da48783d4e05a97da2feb3c9b4a0.png" width="627"></p><h2 id="%E4%B8%89%E3%80%81%E6%96%B9%E6%B3%95%E4%BA%8C%EF%BC%9A%E4%BD%BF%E7%94%A8GitHub%20Desktop%20%E4%B8%8A%E4%BC%A0" name="%E4%B8%89%E3%80%81%E6%96%B9%E6%B3%95%E4%BA%8C%EF%BC%9A%E4%BD%BF%E7%94%A8GitHub%20Desktop%20%E4%B8%8A%E4%BC%A0" style="background-color: rgba(0, 0, 0, 0)">三、方法二：使用GitHub Desktop 上传</h2><blockquote><p>（推荐：偏好图形化、不熟悉命令行）</p></blockquote><p>1.安装工具：下载 GitHub Desktop，安装后登录 GitHub 账号；</p><p>2.克隆远程仓库到本地：</p><p><img alt="" height="660" src="https://i-blog.csdnimg.cn/direct/54af9b364a794eb597f0b7b3ee7df9b4.png" width="960"></p><p>选择你创建的代码仓库</p><p><img alt="" height="660" src="https://i-blog.csdnimg.cn/direct/7548d92de51a4928a3e4e80f675eb301.png" width="960"></p><p>3.复制本地文件到仓库文件夹</p><p><img alt="" height="651" src="https://i-blog.csdnimg.cn/direct/35fcb28ab6124dd8a70be6036c4e2a45.png" width="1694"></p><p>然后可以将你需要上传的文件，直接复制过去。我这里复制了三个图片上来，马上就在软件上看到提示有三个文件更改了。</p><p><img alt="" height="496" src="https://i-blog.csdnimg.cn/direct/f87412c08c9a4068a6a4d59da79b3eda.png" width="1745"></p><p>4.提交变更</p><p><img alt="" height="660" src="https://i-blog.csdnimg.cn/direct/596fa67e5ee14b7a8c453a936d7afefd.png" width="960"></p><p>5.推送到远程仓库，提交之后点击导航栏上的Repository-push，或者你按下快捷键CTRL+P</p><p><img alt="" height="406" src="https://i-blog.csdnimg.cn/direct/bf8e99160e5b471a857ce7c7cd9ea81f.png" width="932"></p><p><img alt="" height="123" src="https://i-blog.csdnimg.cn/direct/c669102c0ba7424897f8e4ad5c725d2e.png" width="872"></p><p>上传成功</p><p><img alt="" height="426" src="https://i-blog.csdnimg.cn/direct/d0d6b82332414fe992ae50a350e16903.png" width="933"></p><h2 id="%E5%9B%9B%E3%80%81%E6%96%B9%E6%B3%95%E4%B8%89%EF%BC%9A%E7%BD%91%E9%A1%B5%E7%AB%AF%E7%9B%B4%E6%8E%A5%E4%B8%8A%E4%BC%A0" name="%E5%9B%9B%E3%80%81%E6%96%B9%E6%B3%95%E4%B8%89%EF%BC%9A%E7%BD%91%E9%A1%B5%E7%AB%AF%E7%9B%B4%E6%8E%A5%E4%B8%8A%E4%BC%A0">四、方法三：网页端直接上传</h2><blockquote><p>（推荐：少量文件、临时快速上传）适用场景：仅上传 1-10 个小文件（单文件＜25MB）、无需安装工具、临时分享文件。</p></blockquote><p><img alt="" height="707" src="https://i-blog.csdnimg.cn/direct/7179ea09f71447a5b16fd890e6c49617.png" width="1915"></p><p><img alt="" height="441" src="https://i-blog.csdnimg.cn/direct/6c43b1175af8476c8c4bbea130cbe8c9.png" width="940"></p><p><img alt="" height="817" src="https://i-blog.csdnimg.cn/direct/4175ff5ead1445159d3339b54a6447e9.png" width="1717"></p><h2 id="%E6%80%BB%E7%BB%93" name="%E6%80%BB%E7%BB%93" style="background-color: rgba(0, 0, 0, 0)">总结</h2><p>网页端模式，无法直接选择文件夹上传，需手动逐个选中文件夹内的文件，若文件数量多（如超过 10 个），会非常耗时，不适合交包含多文件的完整作品。</p><p>命令行模式，此方法比较方便 —— 尤其当作品包含多个文件（如源码、文档、资源文件夹，超 10 个文件）时，能一次性上传完整结构，无需逐个选文件。</p><p>图形界面模式，若不熟悉命令行、担心报错处理，此方法是折中选择 —— 既能像命令行一样上传完整文件夹，又能通过图形界面操作，减少命令记忆成本，算是最方便的。</p><p>根据你的需求选择不同的方式这样是最好的。</p></div>
---
<div style="background: rgba(255, 247, 237, 1); padding: 20px; border-bottom: 3px solid rgba(249, 115, 22, 1); margin-top: 30px">
<h3 style="color: rgba(194, 65, 12, 1); margin-top: 0; font-size: 16px"> 知识拓展</h3>
<p style="color: rgba(102, 102, 102, 1); font-size: 13px; margin-bottom: 12px">根据本文内容，精选以下优质课程：</p>
<ul style="line-height: 2; font-size: 14px; padding-left: 20px">
<li><strong>玩转Git三剑客</strong> — <span style="color: rgba(136, 136, 136, 1); font-size: 13px">高效使用Git进行代码管理</span></li>
<li><strong>MySQL实战45讲</strong> — <span style="color: rgba(136, 136, 136, 1); font-size: 13px">MySQL性能优化核心技术，深入讲解索引原理</span></li>
</ul>
</div><br><br>
来源：https://www.cnblogs.com/ljbguanli/p/19307662
頁:
[1]