一、前言
- 为什么要用 VSCode + GitHub？
- GitHub：全球最大代码托管平台，支持版本控制和协作开发
- VSCode：轻量级代码编辑器，内置 Git 支持，无缝集成 GitHub
- 适用场景：个人项目管理、团队协作、开源贡献
二、准备工作
1. 注册 GitHub 账号
- 访问 GitHub 官网 注册账号
- 验证邮箱（重要！否则无法推送代码）
2. 安装必要工具
3. 配置 Git 全局信息（必做！）
git config --global user.name "你的 GitHub 用户名"
git config --global user.email "你的 GitHub 注册邮箱"
验证配置：
git config --global --list
三、连接 GitHub 与 VSCode
方法 1：HTTPS 协议（适合新手）
- 在 VSCode 中登录 GitHub
- 安装扩展 GitHub Pull Requests and Issues
- 按
Ctrl+Shift+P输入GitHub: Sign in，选择浏览器授权
- 克隆仓库
- 点击 VSCode 左侧活动栏的 源代码管理图标 → 克隆存储库
- 输入 GitHub 仓库 HTTPS 地址（如
https://github.com/用户名/仓库名.git）
方法 2：SSH 协议（更安全，免密码）
生成 SSH 密钥
ssh-keygen -t ed25519 -C "[email protected]"
测试连接
ssh -T [email protected]
看到 Hi 用户名! 表示成功。
将公钥添加到 GitHub
复制公钥内容：cat ~/.ssh/id_ed25519.pub
GitHub → Settings → SSH and GPG keys → New SSH Key
四、实战操作：上传与克隆代码
1. 初始化本地仓库
git init
git remote add origin https://github.com/用户名/仓库名.git
2. 提交并推送
git add .
git commit -m "首次提交"
git push -u origin main
3. 克隆仓库到本地
git clone [email protected]:用户名/仓库名.git
或通过 VSCode 直接克隆：Ctrl+Shift+P → Git: Clone
4. 同步远程更新
git pull origin main
或通过 VSCode 界面点击 源代码管理面板的同步按钮
五、常见问题解决
1. 推送失败：权限被拒绝
- SSH 协议：检查密钥是否添加正确
- HTTPS 协议：更新凭据
git config --global credential.helper manager-core
2. 合并冲突
- 冲突文件会包含
<<<<<<<标记
手动修改后执行：
git add 冲突文件
git commit -m "解决冲突"
3. 错误：fatal: refusing to merge unrelated histories
强制合并不相关历史：
git pull origin main --allow-unrelated-histories
六、效率技巧
- VSCode 快捷键
Ctrl+Shift+G：打开 Git 面板Ctrl+Shift+P：快速执行 Git 命令
- Git 图形化操作
- 右键文件 → 暂存更改
- 提交历史中右键提交 → 撤销提交
- .gitignore 文件
忽略无需上传的文件（如
node_modules/）