MACOS 实验课 · 2026第一部分 / 推送到 Gitee
BEGINNER'S FIELD GUIDE · 01
从零推送到
Gitee
一堂给小白的代码出发课：注册邮箱、打通 SSH，再让 OpenCode 帮你完成第一次提交与推送。
开始第一步↓今日路线6 STOPS
起邮钥仓达
opencode
› 帮我安全地推送这个项目
✓ main → origin/main最终成果：在 Gitee 看见自己的代码与首次提交。
上课前确认- 一台 macOS 电脑
- 可接收短信的手机号
- 已安装并可使用 OpenCode
- 课堂项目文件夹
跟着路线，一站一站来
你的第一次代码远行
每完成一步，就亲手打一个勾。切换页面或刷新后，进度仍会保留。老师讲邮箱就像你在互联网上的收件地址。Gitee 会向它发送验证邮件，所以必须能正常收信。
01 学员操作
- 打开网易邮箱注册页，选择一个容易记住、适合长期使用的邮箱名。
- 设置一个独立密码，不要和课堂电脑的开机密码相同。
- 按页面提示完成手机号验证，然后进入收件箱。
- 把完整邮箱地址记下来，例如 name@163.com；下一步会用到。
打开 163 邮箱↗!验证码和邮箱密码只能由你自己输入，不要发给老师、同学或 OpenCode。
遇到问题？展开排查 +
- 邮箱名已被占用：换一个组合，不要反复尝试相同名字。
- 收不到短信：检查手机号和网络，等待一分钟后再试。
老师讲Gitee 是保存代码的网络平台。用户名会出现在仓库地址中，建议使用简短的英文或拼音。
01 学员操作
- 打开 Gitee 注册页，填写昵称、163 邮箱和密码。
- 谨慎设置个性地址（用户名）；它会成为仓库网址的一部分。
- 完成页面要求的安全验证。
- 回到 163 邮箱，打开 Gitee 的验证邮件并完成激活。
- 重新登录 Gitee，确认右上角能看到自己的头像或昵称。
打开 Gitee 注册页↗!Gitee 官方也建议使用国内邮箱接收激活邮件。密码和验证码不要粘贴进 OpenCode。
遇到问题？展开排查 +
- 没有验证邮件：先查看垃圾邮件，再在 Gitee 登录页使用“重发激活邮件”。
- 用户名不可用：加入课程年份或简短数字。
老师讲仓库是一只装代码的文件夹；提交是一张“这次改了什么”的存档；推送则是把本地存档送到 Gitee。
01 学员操作
- 在访达中找到老师发放的课堂项目文件夹。
- 右键文件夹，选择“新建位于文件夹位置的终端窗口”；如果没有该选项，打开终端后输入 cd，再把文件夹拖进去。
- 在终端输入 opencode 并回车，进入 OpenCode。
TERMINAL · 可用性检查
opencode
!这不是安装教程。如果命令不存在，请举手，让老师检查教学电脑环境。
04STEP
第二站 · 告诉 Git 你是谁
配置 Git 姓名和邮箱
老师讲Git 会在每次提交旁写下作者信息。这里使用你的名字和刚注册的 163 邮箱。
01 学员操作
- 复制下面的提示词，替换两个中文占位符。
- 粘贴到 OpenCode，并阅读它准备执行的命令。
- 如果 OpenCode 请求执行 git config，确认姓名和邮箱无误后批准。
- 让 OpenCode 再读取一次配置，核对结果。
OPENCODE 提示词 · 发给 OpenCode
请帮我为 Git 配置全局用户名“你的姓名”和邮箱“你的163邮箱”。先解释将执行什么命令，再执行；完成后读取配置让我核对。不要读取或展示任何密码。
遇到问题？展开排查 +
- 写错了：用同一条提示词再配置一次，新的值会覆盖旧值。
- 邮箱不是密码；这里可以填写完整的 @163.com 地址。
老师讲SSH 密钥是一对钥匙：公钥像可以公开的锁，私钥是真正开锁的钥匙。公钥交给 Gitee，私钥永远留在电脑里。
01 学员操作
- 将提示词中的邮箱换成你自己的 163 邮箱。
- 让 OpenCode 先检查 ~/.ssh/id_ed25519 是否已经存在，避免覆盖旧密钥。
- 没有旧密钥时，批准它运行 ssh-keygen。课堂练习可按三次回车使用默认位置。
- 只让 OpenCode 显示以 .pub 结尾的公钥文件。
OPENCODE 提示词 · 发给 OpenCode
我要为 Gitee 配置 SSH。请先检查 ~/.ssh/id_ed25519 是否存在，绝对不要覆盖已有密钥。若不存在，用 ed25519 和备注“你的163邮箱”生成密钥。只显示 ~/.ssh/id_ed25519.pub 公钥，永远不要读取、显示或发送私钥。每一步先解释再执行。
!危险边界：id_ed25519 是私钥，id_ed25519.pub 才是公钥。没有 .pub 的文件绝不能复制。
遇到问题？展开排查 +
- 发现已有密钥：不要覆盖，举手让老师确认是否可以直接使用现有公钥。
- 提示权限确认：只批准查看 .pub 公钥，不批准上传或分享私钥。
老师讲现在把“锁”登记到 Gitee。以后只有持有对应私钥的这台电脑，才能以你的身份推送。
01 学员操作
- 登录 Gitee，进入“设置”，找到“安全设置 → SSH 公钥”。
- 标题填写容易识别的名字，例如“教室 Mac”。
- 复制上一页完整的公钥一行，粘贴到公钥输入框并保存。
- 如果 Gitee 要求账号密码或安全验证，请自己完成，不要交给 OpenCode。
- 回到 OpenCode，用下面提示词测试连接。首次连接时确认域名确实是 gitee.com，再输入 yes。
打开 Gitee SSH 公钥设置↗OPENCODE 提示词 · 发给 OpenCode
请运行 ssh -T git@gitee.com 测试 SSH 连接。先解释首次连接可能出现的确认提示；如果需要密码、验证码或私钥，请立即停下让我自己处理。最后用中文解释测试结果。
遇到问题？展开排查 +
- Permission denied (publickey)：检查粘贴的是完整公钥，且当前登录的是正确 Gitee 账号。
- 首次询问 yes/no：核对目标为 gitee.com 后输入 yes。
07STEP
第四站 · 创建远程仓库
在 Gitee 新建空仓库
老师讲远程仓库是项目在 Gitee 上的家。为了避免首次推送冲突，这次创建一个真正的空仓库。
01 学员操作
- 点击 Gitee 右上角的加号，选择“新建仓库”。
- 仓库名称填写 git-class-demo，路径会自动生成。
- 课堂练习建议选择“私有”，除非老师要求公开。
- 不要勾选使用 README、.gitignore 或许可证初始化仓库。
- 创建后找到“克隆/下载”，切换到 SSH，复制 git@gitee.com:... 开头的地址。
前往 Gitee 新建仓库↗!仓库地址可以发给 OpenCode；账号密码、验证码和私钥仍然不可以。
08STEP
第五站 · 制作第一份存档
让 OpenCode 初始化并提交
老师讲先让 OpenCode检查文件，再创建 Git 仓库。提交前一定要看清哪些文件会被保存，避免把密码或配置秘密一起提交。
01 学员操作
- 把提示词发给 OpenCode，让它检查目录和敏感文件。
- 阅读 git status 的文件清单；发现 .env、密钥或密码文件时先停下。
- 确认清单安全后，批准初始化、设置 main 分支、暂存和提交。
- 检查 OpenCode 给出的提交摘要。
OPENCODE 提示词 · 发给 OpenCode
请检查当前课堂项目是否适合提交到 Git。先查找并提醒我任何 .env、密钥、密码或体积异常的文件，未经我确认不要提交。确认安全后：初始化 Git 仓库，将默认分支设为 main，展示 git status，再创建首次提交，提交信息为“完成课堂项目初稿”。每一步先解释并等待必要批准。
遇到问题？展开排查 +
- 提示 nothing to commit：项目可能已经提交过，让 OpenCode 显示 git log 核对。
- 出现敏感文件：先加入 .gitignore，再重新检查，不能为了继续课堂而忽略警告。
老师讲origin 是远程仓库的常用简称。第一次推送会让本地 main 分支记住 Gitee 上的 main 分支。
01 学员操作
- 把刚复制的 SSH 地址替换进提示词。
- 让 OpenCode先检查现有远程地址，避免覆盖别人的配置。
- 核对目标域名是 gitee.com、用户名和仓库名都正确。
- 批准添加 origin 并执行首次推送。
OPENCODE 提示词 · 发给 OpenCode
请把当前项目推送到 Gitee。SSH 仓库地址是“你的仓库SSH地址”。先运行 git remote -v 检查现有远程；若已有 origin，不要覆盖，先向我说明。确认安全后添加 origin，并执行 git push -u origin main。遇到密码、验证码或私钥请求时立即停下。最后解释推送结果。
遇到问题？展开排查 +
- remote origin already exists：让 OpenCode 展示现有地址，确认后再决定是否修改。
- src refspec main does not match：通常是还没有提交，回到上一步检查 git log。
- Repository not found：重新从 Gitee 仓库页复制 SSH 地址。
老师讲命令没有报错只是一个信号，真正的验收是在 Gitee 页面看到文件和提交记录。
01 学员操作
- 回到 Gitee 仓库页面并刷新。
- 确认页面展示的是 main 分支。
- 打开一两个文件，确认内容与本地项目一致。
- 进入提交记录，找到“完成课堂项目初稿”。
老师讲SSH 和远程仓库只需配置一次。以后修改代码，只重复“检查 → 提交 → 推送”。
01 学员操作
- 完成一次小修改后，在项目目录启动 OpenCode。
- 让它先展示差异和敏感信息检查，再提交。
- 核对无误后推送到已经配置好的 origin。
OPENCODE 提示词 · 以后可以复用的提示词
请帮我安全地提交并推送当前改动：先展示 git status 和变更摘要，检查是否包含密码、密钥、.env 或不应提交的大文件；等我确认后创建一条准确的中文提交信息并提交，最后推送到现有 origin。不要修改远程地址，不要读取任何私钥。
!OpenCode 是助手，不是保险箱。批准命令前先读清楚，敏感信息永远由你自己保管。