VSCode 上传项目到 GitHub 完整教程本教程适用于已拥有 GitHub 账号、已创建 GitHub 仓库、想用 VSCode或 Trae图形界面将本地项目上传到 GitHub 的用户。无需任何命令行基础按照步骤逐步操作即可。目录前置准备方式一HTTPS 上传推荐新手方式二SSH 上传推荐长期使用日常使用修改代码后如何同步常见问题排查1. 前置准备1.1 安装 Git打开 https://git-scm.com/downloads下载对应操作系统的安装包一路 Next 安装保持默认选项即可验证安装打开 VSCode 终端菜单栏终端-新建终端输入git --version能看到版本号如git version 2.43.0说明安装成功1.2 配置 Git 用户信息在 VSCode 终端中执行把名字和邮箱换成你自己的git config --global user.name 你的名字 git config --global user.email 你的邮箱example.com邮箱建议用 GitHub 注册邮箱这样 GitHub 能正确关联你的提交验证配置git config --global user.name git config --global user.email1.3 在 GitHub 创建仓库登录 https://github.com点击右上角-New repository填写信息Repository name你的仓库名如my-project建议用英文Description项目描述可选Visibility选择Public公开或Private私有不要勾选Add a README file、Add .gitignore、Choose a license本地已有项目就不勾点击Create repository创建完成后页面会显示仓库地址复制这个地址后面要用HTTPS 地址格式https://github.com/用户名/仓库名.gitSSH 地址格式gitgithub.com:用户名/仓库名.git1.4 认识源代码管理面板在 VSCode或 Trae中点击左侧栏的源代码管理图标形状像树杈/分支快捷键CtrlShiftG打开面板。面板底部有四个小标签标签作用更改显示当前有变更的文件在这里暂存和提交代码存储库查看提交历史、管理分支、比较差异智能体审查AI 辅助审查代码变更自动发现潜在问题图形Git 分支图可视化直观展示提交历史和分支关系日常使用最频繁的是更改标签——提交代码、推送代码都在这里完成。2. 方式一HTTPS 上传推荐新手HTTPS 方式不需要配置 SSH 密钥适合第一次使用。但每次推送可能需要输入账号密码可配置免密。第 1 步用 VSCode 打开你的项目文件夹打开 VSCode菜单栏文件-打开文件夹选择你的项目文件夹第 2 步初始化 Git 仓库打开源代码管理面板CtrlShiftG点击初始化仓库按钮Initialize Repository或者用菜单查看-命令面板CtrlShiftP- 输入Git: Initialize Repository- 回车初始化后项目根目录会出现一个.git隐藏文件夹不要手动删除它第 3 步创建 .gitignore 文件重要在项目根目录创建.gitignore文件排除不需要上传的文件。内容参考# 敏感文件 .env .env.* # Python __pycache__/ *.py[cod] venv/ .venv/ # IDE .idea/ .trae/ .vscode/ # 日志和运行时 logs/ *.log uploads/ # 系统文件 .DS_Store Thumbs.db不创建 .gitignore 也能上传但会把缓存文件、敏感信息一起传上去不建议跳过第 4 步暂存所有文件打开源代码管理面板在更改标签下你会看到所有未跟踪的文件将鼠标移到更改标题上点击号暂存所有更改也可以单个文件暂存鼠标移到文件上点击该文件右侧的号第 5 步提交Commit在源代码管理面板顶部的输入框中输入提交信息如初始化项目点击输入框上方的勾号 ✓提交按钮或按CtrlEnter提交完成后更改列表会清空底部状态栏显示main分支名第 6 步关联远程仓库打开终端Ctrl 或菜单终端-新建终端执行以下命令把地址换成你的 HTTPS 仓库地址git remote add origin https://github.com/用户名/仓库名.git验证是否添加成功git remote -v应显示两行origin开头的地址第 7 步推送Push到 GitHub回到源代码管理面板点击面板右上角的...更多操作选择推送Push首次推送时VSCode 会弹窗提示当前分支没有上游分支点击确定或选择origin/main第 8 步GitHub 认证首次首次推送时会弹出 GitHub 登录窗口点击Sign in with your browser用浏览器登录浏览器会打开 GitHub 授权页面点击Authorize授权回到 VSCode提示登录成功如果弹出输入框要求输入用户名和密码用户名你的 GitHub 用户名密码不是 GitHub 登录密码需要使用 Personal Access Token创建 TokenGitHub - Settings - Developer settings - Personal access tokens - Generate new token勾选repo权限生成后复制 Token粘贴到密码输入框第 9 步验证上传成功打开你的 GitHub 仓库页面https://github.com/用户名/仓库名能看到你的项目文件说明上传成功VSCode 底部状态栏会显示同步状态不再有云上传图标3. 方式二SSH 上传推荐长期使用SSH 方式配置好密钥后以后推送不再需要输入密码适合长期使用。前期配置稍多。第 1 步检查是否已有 SSH 密钥打开 VSCode 终端执行ls ~/.ssh如果看到id_ed25519.pub或id_rsa.pub说明已有密钥跳到第 3 步如果提示目录不存在或为空继续第 2 步生成密钥第 2 步生成 SSH 密钥在终端执行把邮箱换成你的 GitHub 邮箱ssh-keygen -t ed25519 -C 你的邮箱example.com提示Enter file in which to save the key直接回车保持默认路径提示Enter passphrase可以直接回车不设密码或输入一个密码保护密钥提示Enter same passphrase again再次输入同样的内容生成成功后会显示密钥的指纹和随机艺术图第 3 步将公钥添加到 GitHub查看公钥内容cat ~/.ssh/id_ed25519.pub如果用的是 RSA文件名是id_rsa.pub复制输出的全部内容以ssh-ed25519开头以你的邮箱结尾打开 GitHubhttps://github.com/settings/keys点击New SSH key填写Title随便起个名字如我的电脑Key typeAuthentication KeyKey粘贴刚才复制的公钥点击Add SSH key第 4 步测试 SSH 连接在终端执行ssh -T gitgithub.com首次连接会提示Are you sure you want to continue connecting输入yes回车看到以下信息说明成功Hi 用户名! Youve successfully authenticated, but GitHub does not provide shell access.第 5 步用 VSCode 打开项目文件夹菜单栏文件-打开文件夹选择你的项目文件夹第 6 步初始化 Git 仓库打开源代码管理面板CtrlShiftG点击初始化仓库按钮第 7 步创建 .gitignore 文件在项目根目录创建.gitignore文件内容参考第 2 节第 3 步。第 8 步暂存并提交在源代码管理面板点击更改标题旁的号暂存所有在输入框输入提交信息如初始化项目点击勾号 ✓提交第 9 步关联远程仓库SSH 地址打开终端执行把地址换成你的 SSH 仓库地址git remote add origin gitgithub.com:用户名/仓库名.git验证git remote -v第 10 步推送到 GitHub回到源代码管理面板点击...-推送首次推送提示无上游分支点击确定SSH 方式不需要输入密码如果生成密钥时没设 passphrase直接推送成功第 11 步验证打开 GitHub 仓库页面能看到项目文件说明上传成功。4. 日常使用修改代码后如何同步项目首次上传后日常修改代码的同步流程4.1 提交修改修改代码后打开源代码管理面板在更改下会看到修改过的文件文件名旁有 M 标记在输入框输入提交信息如修复推荐功能bug点击勾号 ✓提交4.2 推送到 GitHub点击源代码管理面板的...选择推送或者直接点击底部状态栏的同步图标云朵带箭头一步完成提交推送4.3 从 GitHub 拉取更新如果在其他设备上修改了代码或其他人推了新代码点击源代码管理面板的...选择拉取Pull5. 常见问题排查Q1推送时报错failed to push some refs原因GitHub 仓库有本地没有的提交比如在 GitHub 上创建了 README解决先拉取再推送终端执行git pull origin main --allow-unrelated-histories再推送Q2HTTPS 推送每次都要输密码解决配置凭据存储git config --global credential.helper store下次输入一次后以后自动记住Q3SSH 推送报错Permission denied (publickey)原因SSH 密钥未正确配置排查确认公钥已添加到 GitHubSettings - SSH and GPG keys测试连接ssh -T gitgithub.com确认 remote 地址是 SSH 格式git remote -v应显示gitgithub.com:...Q4源代码管理面板看不到推送选项原因可能还没提交或还没关联远程仓库解决先提交输入信息 点勾号确认已执行git remote add origin ...再点...查看是否有推送选项Q5不小心上传了 .env 等敏感文件解决在.gitignore中添加该文件终端执行git rm --cached .env git commit -m 移除敏感文件 git push重要已上传到 GitHub 的敏感信息即使删除也可能被他人获取建议立即更换密码/密钥Q6VSCode 底部状态栏的分支名显示main*带星号星号表示有未提交的更改。提交并推送后星号消失。附两种方式对比对比项HTTPSSSH配置难度简单无需配置密钥稍复杂需生成密钥并添加到 GitHub认证方式用户名 Token或浏览器授权SSH 密钥自动认证推送体验首次需登录之后可记住无需输入密码未设 passphrase 时安全性Token 有过期时间密钥不过期更安全适用场景新手、偶尔使用长期开发、多项目管理建议如果你是第一次操作先用 HTTPS 方式跑通流程。熟练后切换到 SSH 方式体验更顺畅。附切换 HTTPS 和 SSH如果想从 HTTPS 切换到 SSH或反过来修改 remote 地址即可# 查看当前 remote 地址 git remote -v # 切换为 SSH git remote set-url origin gitgithub.com:用户名/仓库名.git # 切换为 HTTPS git remote set-url origin https://github.com/用户名/仓库名.git本文档创建于 2026 年 7 月。GitHub 界面可能随版本更新有所变化但核心流程不变。