1. 项目概述作为一名长期在开发一线摸爬滚打的程序员我深知版本控制的重要性。GitHub作为全球最大的代码托管平台已经成为开发者必备的工具之一。但很多刚入门的同行在将本地项目上传到GitHub时总会遇到各种坑——从.gitignore配置不当泄露敏感信息到分支管理混乱导致代码冲突。今天我就以Cursor这个轻量级编辑器为例手把手带你走通整个上传流程。Cursor虽然不像VS Code那样功能全面但它的Git集成做得相当不错。更重要的是这套方法同样适用于其他主流编辑器如VS Code、IntelliJ IDEA等和代码托管平台如GitLab、Gitee。我会在演示过程中特别标注那些通用技巧让你一次学习多处适用。2. 环境准备与基础配置2.1 安装必要工具链首先确保你的系统已经安装Git版本2.30Cursor编辑器1.4版本GitHub账户验证Git安装git --version如果尚未安装推荐使用官方安装包Windows下载Git for WindowsmacOS通过Homebrew运行brew install gitLinux使用系统包管理器如apt install git注意安装时务必勾选将Git添加到系统PATH选项否则Cursor可能无法调用Git命令2.2 配置Git全局信息在任意终端执行git config --global user.name 你的GitHub用户名 git config --global user.email 你的GitHub注册邮箱这个配置会写入~/.gitconfig文件是所有Git操作的基础。建议使用GitHub的主邮箱否则贡献图可能无法正确显示。2.3 Cursor中的Git设置打开Cursor设置Ctrl,搜索Git: Path指定git可执行文件路径如/usr/bin/git启用Git: Enable选项实操技巧如果Cursor无法识别Git尝试重启编辑器或检查PATH环境变量3. 项目初始化与本地仓库管理3.1 创建本地Git仓库在Cursor中打开项目文件夹CtrlO右键项目根目录 → 选择Initialize Repository观察底部状态栏出现Git分支标识默认为master/main或者使用命令行cd /your/project/path git init3.2 .gitignore的最佳实践在项目根目录创建.gitignore文件推荐内容# 通用忽略规则 node_modules/ .DS_Store *.log .env .idea/ # 根据项目类型添加 # Python开发者添加 __pycache__/ *.py[cod] # Java开发者添加 target/ *.class避坑指南务必在首次commit前设置好.gitignore否则后续需要运行git rm -r --cached .清除已跟踪的无效文件3.3 初始提交流程在Cursor左侧导航栏点击Git图标或按CtrlShiftG查看Changes选项卡下的文件变动点击暂存所有文件或右键单个文件选择Stage Changes填写提交信息如Initial commit点击√提交按钮等效命令行操作git add . git commit -m Initial commit4. 连接GitHub远程仓库4.1 创建GitHub仓库登录GitHub → 点击New repository填写仓库名建议与本地项目名一致选择Public/Private不要勾选Initialize with README避免后续合并冲突点击Create repository4.2 添加远程仓库地址获取仓库HTTPS/SSH地址后在Cursor中打开命令面板CtrlShiftP搜索并执行Git: Add Remote输入远程名称通常用origin粘贴仓库地址如https://github.com/username/repo.git或者使用终端git remote add origin https://github.com/username/repo.git安全提示推荐配置SSH密钥认证避免频繁输入密码生成密钥ssh-keygen -t ed25519 -C your_emailexample.com将~/.ssh/id_ed25519.pub内容添加到GitHub SSH Keys4.3 推送代码到远程仓库首次推送需要设置上游分支git push -u origin main后续推送只需git push在Cursor中的可视化操作点击底部状态栏的分支名称选择Publish Branch首次推送会弹出远程选择窗口5. 高级操作与问题排查5.1 处理推送冲突当远程仓库有更新而本地未拉取时会报错! [rejected] main - main (non-fast-forward)解决方案git pull --rebase origin main git push经验之谈养成git pull --rebase的习惯比直接git pull能保持更清晰的提交历史5.2 分支管理策略推荐工作流主分支main稳定版本开发分支dev集成测试功能分支feature/xxx单个功能开发创建新分支git checkout -b feature/login在Cursor中点击底部左下方分支名称选择Create New Branch输入分支名并确认5.3 常见错误解决方案认证失败症状remote: Invalid username or password解决更新凭据管理器中的密码或切换到SSH协议大文件无法推送症状remote: error: File large_file.zip is 1024.00 MB解决从历史中移除大文件git filter-branch --tree-filter rm -f large_file.zip HEAD或使用Git LFS管理大文件6. 跨平台通用技巧6.1 VS Code用户注意操作流程与Cursor完全一致只是Git面板默认在左侧活动栏推送命令在...菜单中6.2 IntelliJ系列IDE额外功能自动.gitignore生成变更列表(Changelist)管理更强大的冲突解决工具6.3 其他代码平台适配GitLab/Gitee的区别仅在于远程仓库地址不同PR叫Merge RequestGitLab部分平台需要配置Webhook实现CI/CD7. 效率提升技巧7.1 Cursor专属快捷键查看Git历史CtrlShiftH快速提交CtrlEnter在提交信息框内切换分支CtrlShiftB7.2 命令行增强推荐别名配置~/.bashrcalias gsgit status alias gcgit commit -m alias gpgit push alias glgit log --oneline --graph7.3 图形化工具推荐GitLensCursor/VS Code扩展Sourcetree跨平台GUILazygit终端TUI工具我在实际项目中发现合理结合命令行和GUI工具效率最高——日常操作用Cursor的Git面板复杂操作如rebase用命令行更可控。记住一个原则无论用什么工具理解背后的Git原理才是关键。比如当冲突发生时知道如何手动解决比依赖工具自动合并更重要。
