在手机上使用 Git 和 GitHub

过去在手机上管理仓库一直很麻烦。有了 Pocket Code，它就像在桌面端一样简单。

初始设置

1. 连接你的 GitHub 账户

1. 在 Pocket Code 中打开 设置
2. 进入 集成 → GitHub
3. 点击 使用 GitHub 连接
4. 授权该应用

完成！现在你可以访问所有仓库了。

2. 克隆仓库

有三种克隆方式：

方式 A：从应用中

1. 在主屏幕上点击 "+" 按钮
2. 选择 "克隆仓库"
3. 搜索或粘贴 URL
4. 选择本地位置

方式 B：从浏览器

1. 在 GitHub Mobile 中打开仓库
2. 点击 "分享"
3. 选择 "使用 Pocket Code 打开"

方式 C：使用 Git 命令

git clone https://github.com/username/repo.git

基本工作流程

修改文件

1. 像平常一样编辑文件
2. 修改会被自动标记
3. 点击文件即可查看差异

提交并推送

# 查看状态
git status

# 添加更改
git add .

# 提交
git commit -m "Fix: correct login bug"

# 推送
git push origin main

或者使用可视化界面：

• 点击 Git 图标
• 审查更改
• 编写提交信息
• 点击 "提交并推送"

高级功能

1. 分支管理

# 查看分支
git branch

# 创建分支
git checkout -b feature/new-functionality

# 切换分支
git checkout main

# 合并
git merge feature/new-functionality

2. 拉取请求（Pull Request）

1. 在分支中进行更改
2. 推送该分支
3. 点击 "创建 Pull Request"
4. 填写标题和描述
5. 指派审查者（可选）
6. 创建 PR

3. 解决冲突

当出现冲突时：

1. Pocket Code 会自动检测它们
2. 显示有冲突的文件
3. 打开文件
4. 并排查看差异
5. 选择要保留的更改
6. 保存并提交

# 手动解决后
git add conflict-file.js
git commit -m "Resolve conflict in conflict-file.js"

4. 暂存更改（Stash）

临时保存更改：

# 保存更改
git stash

# 查看暂存列表
git stash list

# 恢复更改
git stash pop

常见工作流程

工作流程 1：快速修复

# 1. 确保你在 main 分支上
git checkout main

# 2. 拉取最新更改
git pull

# 3. 进行修复
# ... 编辑文件 ...

# 4. 提交并推送
git add .
git commit -m "Fix: urgent production bug"
git push

工作流程 2：新功能

# 1. 从 main 创建分支
git checkout main
git pull
git checkout -b feature/new-api

# 2. 开发
# ... 实现该功能 ...

# 3. 频繁提交
git add .
git commit -m "feat: add /api/users endpoint"

# 4. 推送并创建 PR
git push -u origin feature/new-api
# 然后在应用中创建 PR

工作流程 3：热修复（Hotfix）

# 1. 从 production 创建分支
git checkout production
git checkout -b hotfix/critical-bug

# 2. 快速修复
# ... 修复 ...

# 3. 提交并直接合并
git add .
git commit -m "hotfix: fix critical error"
git checkout production
git merge hotfix/critical-bug
git push

最佳实践

提交

✅ 好的提交信息：

feat: add Google login
fix: correct email validation
docs: update README with instructions
refactor: simplify search function

❌ 不好的提交信息：

changes
fix
wip
asdfgh

分支

使用具有描述性的名称：

• feature/feature-name
• fix/bug-description
• hotfix/critical-issue
• refactor/refactor-name

推送之前

1. ✅ 审查你的更改
2. ✅ 运行测试（如果有的话）
3. ✅ 推送前先拉取（避免冲突）
4. ✅ 编写描述性的提交信息

高级配置

SSH 密钥

为了避免每次都进行身份验证：

1. 在 Pocket Code 中生成 SSH 密钥
2. 复制公钥
3. 将它添加到 GitHub Settings → SSH Keys
4. 使用 SSH URL：[email protected]:user/repo.git

.gitignore

创建 .gitignore 来忽略文件：

# Dependencies
node_modules/
venv/
__pycache__/

# Build outputs
dist/
build/
*.pyc

# Environment
.env
.env.local

# IDE
.vscode/
.idea/

# OS
.DS_Store
Thumbs.db

Git 钩子（Hooks）

自动化任务：

# .git/hooks/pre-commit
#!/bin/sh
npm run lint
npm test

协作

在手机上进行代码审查

1. 打开 PR
2. 逐个文件查看更改
3. 在特定行上添加评论
4. 批准或请求修改

讨论

• 回复评论
• 使用 @username 提及协作者
• 使用表情符号进行快速回应

故障排查

"无法推送"

# 先拉取
git pull origin main

# 如果有冲突则解决冲突
# 然后推送
git push

"我克隆了仓库但看不到文件"

请检查：

1. 你是否在正确的目录中？
2. 仓库是否为空？
3. 日志中是否有错误？

"更改没有出现在 GitHub 上"

# 确认你已推送
git status

# 如果显示 "Your branch is ahead"
git push

结语

有了 Pocket Code，你在手机上就拥有了 Git 和 GitHub 的全部能力。再也没有借口不去完成那个紧急的提交了。

下一篇教程：使用 Vercel 从 GitHub 自动部署

有疑问？加入我们的 Discord

祝编码愉快！🚀