用 Git 配合 OpenCode — 现有项目快速初始化指南

在已有项目文件夹里快速配好 Git，其实就几步。这里是完整流程：

---

1. 初始化仓库并完成首次提交

在项目根目录下打开终端，依次执行：

# 初始化 Git 仓库
git init

# 添加所有现有文件到暂存区
git add .

# 创建首次提交，记录项目的初始状态
git commit -m "初始提交：项目原始状态"

完成这一步后，项目就处于版本控制中了。

---

2. 添加 .gitignore 文件

为避免把依赖包、环境配置、编译产物等提交进去，建议在根目录创建一个 .gitignore 文件。

下面是一些常见条目，按需选用：

# 依赖
node_modules/
vendor/

# 编译输出
dist/
build/
*.pyc
__pycache__/

# 环境与密钥
.env
*.local
*.secret

# 系统文件
.DS_Store
Thumbs.db

# IDE
.vscode/
.idea/

创建后重新提交一次：

git add .gitignore
git commit -m "添加 .gitignore"

---

3. 配合 opencode 的安全工作流

既然 opencode 会直接修改源文件，推荐养成这个习惯：每次让 opencode 做大改动前，先手动提交一次。

# 确认当前没有未提交的改动
git status

# 如果有改动，先提交，相当于存个"安全点"
git add -A
git commit -m "准备让 AI 修改 xxx 功能前的状态"

然后让 opencode 执行修改。结束后用以下命令查看差异：

# 查看所有改动详情
git diff

# 查看改了哪些文件
git status

---

4. 如何回退 opencode 的修改

如果对 AI 的改动不满意，回退非常简单：

# 丢弃所有未提交的改动，恢复到上次提交时的干净状态
git checkout .

# 如果已经有新增的未跟踪文件，一并删除
git clean -fd

如果你已经提交了 AI 的修改，但想撤销：

# 回退最近一次提交，改动保留在工作区以便重新修改
git reset --soft HEAD~1

---

这样配好后，opencode 的任何操作都是可追溯、可逆的，风险就非常可控了。如果你还想要一个一键保存状态、方便来回切换的快捷方式，我可以再讲一下用 git stash 临时存储的用法。