当前位置:

首页 > 编程开发 > VSCode怎么上传本地项目到新建的GitHub仓库

VSCode怎么上传本地项目到新建的GitHub仓库

先初始化本地仓库并提交,再创建无README的GitHub空仓库,复制含.git后缀的HTTPS地址,用git remote add、git branch -M main、git push -u origin main完成绑定与推送。 确认本地项目已初始化为 Git 仓库 如果你在项目目录下运行 g

本文目录

    先初始化本地仓库并提交,再创建无README的GitHub空仓库,复制含.git后缀的HTTPS地址,用git remote add、git branch -M main、git push -u origin main完成绑定与推送。

    VSCode怎么上传本地项目到新建的GitHub仓库

    确认本地项目已初始化为 Git 仓库

    如果你在项目目录下运行 git status,却收到“not a git repository”的报错,那说明准备工作还没开始。别急,解决起来很简单:直接进入你的项目根目录,然后按顺序执行下面几个命令。

    • git init —— 这个命令会在当前目录创建一个隐藏的 .git 文件夹,这是仓库的核心。不过,它并不会自动帮你把文件加进去。
    • git add . —— 接下来,用这个命令添加所有文件。注意,命令末尾的那个点号千万不能漏掉,它代表“当前目录所有变更”。
    • git commit -m "initial commit" —— 最后,必须完成这次提交。这是关键一步,没有这个初始提交,后续关联远程仓库的操作很可能会失败。

    怎么确认成功了呢?看一眼VSCode窗口底部的状态栏。如果那里显示了当前分支名(比如 main),那就没问题。如果什么都没看到,那很可能前面的初始化或提交步骤没有真正完成。

    在 GitHub 上创建空仓库并复制 HTTPS 或 SSH 地址

    接下来,打开浏览器,去GitHub上创建一个新仓库。这里有个至关重要的细节:创建时,千万不要勾选 “Initialize this repository with a README” 这个选项。为什么呢?如果你勾选了,GitHub会帮你生成一个包含README文件的初始提交。这样一来,远程仓库就有了提交历史,会和你本地刚做的那个 initial commit 产生冲突,导致后续的 git push 被拒绝。

    创建完成后,页面会跳转到新仓库。找到右上角的绿色“Code”按钮,点击它,你会看到仓库的地址。对于大多数新手来说,建议优先使用HTTPS地址,因为它不需要预先配置SSH密钥,更直接。地址的格式通常是这样的:https://github.com/你的用户名/仓库名.git。

    这里要特别提醒:复制的地址末尾一定要有 .git 后缀。少了这个后缀,虽然 git remote add 命令可能不会报错,但等到执行 push 的时候,很可能会遇到 repository not found 这样的错误提示。

    在 VSCode 终端里绑定远程仓库并推送

    现在,回到VSCode。使用快捷键 Ctrl+` 打开内置终端,并确保终端的工作目录就在你的项目根目录下。然后,依次输入并执行下面三条命令:

    • git remote add origin https://github.com/username/repo-name.git —— 这条命令的作用是为远程仓库起一个别名,这里用了惯例的 origin,当然你也可以用别的名字。
    • git branch -M main —— 这条命令是强制将当前分支重命名为 main。这是因为现在GitHub上新仓库的默认主分支名已经是 main 了,不再是过去的 master,保持同步可以避免 confusion。
    • git push -u origin main —— 最后,执行推送。-u 参数只在第一次推送时需要,它建立了本地分支与远程分支的跟踪关系。之后你再想推送,直接输入 git push 就可以了。

    执行推送命令时,如果用的是HTTPS方式,系统可能会提示你登录GitHub账户。输入用户名和密码即可。如果你的账户启用了双重验证,那么密码需要替换成你在GitHub上生成的 Personal Access Token(生成路径:Settings → Developer settings → Personal access tokens → Tokens,生成时记得勾选 repo 权限)。

    VSCode 图形界面操作的坑与补充

    很多朋友可能会想,VSCode左侧不是有个源代码管理的图标吗?里面好像有个“发布到GitHub”的按钮,能不能直接用那个?答案是:可以,但不推荐,尤其在你已经按照上述步骤操作的情况下。

    那个图形化按钮为了“方便”,会自动做很多事情:比如帮你创建远程仓库、自动生成一个README文件、甚至可能强制使用SSH协议。这些“自动化”操作,恰恰和我们“创建空仓库”、“使用HTTPS”的需求背道而驰。特别是当本地已经存在提交记录时,它可能会悄悄修改你的分支名,或者引发一些意想不到的冲突。

    所以,一个更稳妥、更可控的建议是:在VSCode里,我们只用图形界面来完成代码对比、暂存更改和提交这些操作;而所有涉及远程仓库的操作(添加远程地址、推送),一律通过终端命令行来完成。这样每一步都在你的掌控之中。当然,命令执行成功后,你依然可以在VSCode的图形界面里看到推送进度条和成功提示,因为它的底层调用的其实还是 git push 命令。

    全部完成后,刷新一下你的GitHub仓库页面,应该就能看到项目文件了。如果刷新后只看到一个空仓库页面,或者干脆是404,别慌。这时候,大概率是远程地址写错了、本地和远程的分支名没对上,或者最根本的——你本地最初的那次 commit 其实并没有成功执行。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 GitHub
    相关文章 更多
    GitHub Actions重跑失败作业会使用最新代码吗
    GitHub Actions重跑失败作业会使用最新代码吗

    解释已有运行重跑的提交和权限边界,给出确认、失败作业重跑及结果核对命令,区分漏触发事件。

    GitHub合并故障的已缓解、监控与已解决有什么不同
    GitHub合并故障的已缓解、监控与已解决有什么不同

    GitHub合并故障中的“已缓解并监控”和“已解决”不能互换。前者表示影响已经采取措施缓解,仍在观察稳定性;后者是供应商正式结束这场事故的状态。11月13日的Pull Requests合并超时事件先进入监控,随后于北京时间11月14日02:29标记为已解决。

    GitHub Actions与Checks同时排队失败时,如何区分平台故障?
    GitHub Actions与Checks同时排队失败时,如何区分平台故障?

    GitHub对11月5日Actions与Checks事件的新增复盘指出:数据库服务在高并发大读请求下耗尽资源,导致部分运行无法排队或执行失败。检查类似问题时,先比对平台事件时间与失败状态,再决定是否重试自己的工作流。

    GitHub Actions运行卡住占用并发时,应检查哪些状态?
    GitHub Actions运行卡住占用并发时,应检查哪些状态?

    GitHub对11月9日Actions事件的新增复盘说明:数据库迁移后,新区域容量与速率限制不足导致请求被拒,部分运行在服务恢复后仍占用并发。排查自己的工作流时,应把平台状态、运行状态与应用代码错误分开核对。

    GitHub公开监控告警支持独立链接:定位、收藏和共享单条发现
    GitHub公开监控告警支持独立链接:定位、收藏和共享单条发现

    GitHub Public monitoring支持为单条告警生成独立链接。在企业视图点击告警编号即可打开、收藏或分享对应URL,接收者仍需具备访问权限。

    GitHub Secret Scanning新增Cloudflare服务令牌检测:区分发现、告警与吊销
    GitHub Secret Scanning新增Cloudflare服务令牌检测:区分发现、告警与吊销

    GitHub Secret Scanning新增cloudflare_access_service_token检测类型,可帮助发现仓库中的Cloudflare服务令牌。检测、向签发方报告、生成用户告警和实际吊销是不同动作;本篇说明新检测器与开发团队处置边界,不将功能发布写成已发生泄露。

    GitHub Actions将于12月8日结束ARM32托管作业支持:Windows与Linux需提前检查
    GitHub Actions将于12月8日结束ARM32托管作业支持:Windows与Linux需提前检查

    GitHub公告Windows与Linux托管运行器将于2026年12月8日结束ARM32作业执行支持,包含原生AArch32用户空间执行。原因与Node 20支持结束及Node 24不支持ARM32有关;本篇说明受影响范围、迁移检查与尚未说明的截止时刻。

    GitHub邮件事件已解决:平台处理恢复,上游邮箱延迟仍需区分
    GitHub邮件事件已解决:平台处理恢复,上游邮箱延迟仍需区分

    GitHub已于2026年11月13日05:43:56北京时间关闭邮件投递事件,确认其系统内邮件处理影响消除。紧邻进展仍提示受影响上游邮箱供应商可能延迟;本篇区分平台恢复、收件状态和登录验证流程,避免把事件关闭等同每封邮件送达。

    GitHub Webhooks API已恢复:先前约1%流量超时与错误
    GitHub Webhooks API已恢复:先前约1%流量超时与错误

    GitHub已于2026年11月13日03:33:54北京时间确认Webhooks API事件解决,先前约1%客户流量出现超时与错误。本文说明恢复时间线、CI与智能体工作流的投递核对方法,以及尚未公开的根因边界。

    GitHub邮件投递异常:登录验证已见恢复,部分供应商仍有延迟
    GitHub邮件投递异常:登录验证已见恢复,部分供应商仍有延迟

    GitHub邮件投递事件已进入监控,登录和邮箱验证出现恢复,但部分上游邮件供应商托管的邮箱仍可能延迟。截至2026年11月13日05:18北京时间,官方未宣布完全恢复;本文说明受影响流程、最新范围与登录排查边界。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。