版本控制：PocketCode 内置的 Git

版本控制：PocketCode 内置的 Git

Git 是现代开发的基础。PocketCode 原生集成了 Git，使你无需集成终端即可管理代码。

可视化 Git 界面

更改面板

Git 侧边面板会实时显示：

• 已修改的文件（M）— 待处理的更改
• 新文件（U）— 未跟踪
• 已删除的文件（D）— 已移除
• 冲突（C）— 需要手动解决

可视化差异对比

点击任意已修改的文件，即可并排查看差异：

• 新增的行以绿色显示
• 删除的行以红色显示
• 行内更改以高亮标出

基本操作

进行一次提交

# From the visual interface:
# 1. Select files in the changes panel
# 2. Write the commit message
# 3. Tap "Commit"

# Or from the integrated terminal:
git add .
git commit -m "feat: add authentication system"

使用分支

轻松创建和切换分支：

# Create new branch
git checkout -b feature/new-feature

# List branches
git branch -a

# Switch branch
git checkout main

# Delete branch
git branch -d feature/completed

合并与变基

PocketCode 提供可视化的冲突解决方式：

1. 从 Git 面板启动合并
2. 如果存在冲突，会打开解决编辑器
3. 在两个分支的更改之间进行选择
4. 确认解决方案

工作流

Git Flow

main ─────────────────────── production
  └── develop ─────────────── development
        ├── feature/login ──── feature
        ├── feature/api ────── feature
        └── hotfix/bug-123 ── urgent fix

基于主干的开发（Trunk-Based Development）

main ─────────────────────── single main branch
  ├── short-lived-branch ──── short-lived (< 1 day)
  └── feature-flag ────────── hidden feature

平台集成

GitHub

• 直接 Push/Pull
• 在应用内创建 Pull Requests
• 与提交关联的 Issues
• 可见的 Actions 状态

GitLab

• 完整的仓库支持（浏览、克隆、推送）
• CI/CD 流水线状态
• 代码片段（Snippets）

Bitbucket

• 克隆与推送
• 仓库浏览

目前，从应用内部创建拉取/合并请求仅支持 GitHub。对于 GitLab 和 Bitbucket， 你可以访问仓库、流水线和代码片段；请在它们的 Web 界面中创建 MR/PR。

Git stash

在不提交的情况下临时保存更改：

# Save changes
git stash save "work in progress"

# List stashes
git stash list

# Recover last stash
git stash pop

# Apply specific stash
git stash apply stash@{2}

提交信息技巧

遵循 Conventional Commits 规范以编写清晰的提交信息：

feat: add OAuth2 authentication
fix: correct email validation error
docs: update README with setup instructions
style: format code with Prettier
refactor: simplify price calculation logic
test: add tests for payment module
chore: update dependencies

配置

全局 Git

git config --global user.name "Your Name"
git config --global user.email "[email protected]"
git config --global core.editor "pocket-code"

身份验证

PocketCode 通过 HTTPS 使用 Personal Access Token (PAT) 进行身份验证。在 GitHub、GitLab 或 Bitbucket 上生成一个令牌并粘贴进来——克隆、fetch、pull 以及推送到私有仓库都可以通过这一个令牌完成（在 GitHub 上，令牌填入用户名字段）。每一个本地操作——commit、branch、merge、stash、diff——都无需身份验证，并且完全离线运行。

---

借助集成的 Git，PocketCode 让你完全掌控自己的代码。无需离开 PocketCode 编辑器，即可进行提交、管理分支并与团队协作。