GitHub 集成：完整指南

了解如何连接你的 GitHub 仓库，并直接在手机上的 PocketCode 中管理代码。

在手机上使用 Git 和 GitHub

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

初始设置

1. 连接你的 GitHub 账户

在 PocketCode 中打开设置
进入 集成 → GitHub
点击 使用 GitHub 连接
授权该应用

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

2. 克隆仓库

有三种克隆方式：

方式 A：从应用中

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

方式 B：从浏览器

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

方式 C：使用 Git 命令

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

基本工作流程

修改文件

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

提交并推送

# 查看状态
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）

在分支中进行更改
推送该分支
点击 "创建 Pull Request"
填写标题和描述（如果需要，可将其标记为草稿）
创建 PR

3. 解决冲突

当出现冲突时：

PocketCode 会自动检测它们
显示有冲突的文件
打开文件
并排查看差异
选择要保留的更改
保存并提交

# 手动解决后
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

推送之前

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

高级配置

Personal Access Token

PocketCode 通过 HTTPS 使用 Personal Access Token (PAT) 向 GitHub 进行身份验证：

在 GitHub Settings → Developer settings → Personal access tokens 中创建一个令牌
授予它仓库访问权限
出现提示时将令牌粘贴到 PocketCode 中（在 GitHub 上，令牌填入用户名字段）
使用 HTTPS URL：https://github.com/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

协作

在手机上进行代码审查

打开 PR
查看它已有的审查和批准状态
在 PR 讨论中添加一条评论

提交正式的批准/请求修改审查，以及锚定到具体行的评论，目前还未接入应用——请在 GitHub 的 Web 界面中进行这些操作。PocketCode 如今展示的是 PR 的审查状态和讨论。

讨论

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

故障排查

"无法推送"

# 先拉取
git pull origin main

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

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

请检查：

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

"更改没有出现在 GitHub 上"

# 确认你已推送
git status

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

结语

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

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

有疑问？加入我们的 Discord

祝编码愉快！🚀