Git Daily Workflow Git 日常工作流程 Git 日常工作流程 Git Daily Workflow

Cloning downloads a copy of a repository from Gitea to your computer. You only need to do this once per project. Clone 是從 Gitea 下載一份 repository 副本到你的電腦。每個專案只需要做一次。 Clone 是从 Gitea 下载一份仓库副本到你的电脑。每个项目只需要做一次。 Ang Clone ay nagda-download ng kopya ng repository mula sa Gitea papunta sa iyong computer. Isang beses lang ito kailangan gawin bawat project.

First, find the SSH clone URL on Gitea. Go to the repository page and click the SSH button to copy the URL: 首先，在 Gitea 找到 SSH clone URL。進入 repository 頁面，點擊 SSH 按鈕複製 URL： 首先，在 Gitea 找到 SSH clone URL。进入仓库页面，点击 SSH 按钮复制 URL： Una, hanapin ang SSH clone URL sa Gitea. Pumunta sa repository page at i-click ang SSH button para kopyahin ang URL:

Then run the clone command in your terminal: 然後在終端機執行 clone 指令： 然后在终端执行 clone 命令： Pagkatapos, i-run ang clone command sa iyong terminal:

$ git clone git@git-ssh.datawords.hk:MyOrg/my-project.git
Cloning into 'my-project'...
$ cd my-project

A branch is a separate line of development. Always create a new branch for your work instead of committing directly to develop. 分支（Branch）是一條獨立的開發線。請永遠為你的工作建立新分支，而不是直接在 develop 上提交。 分支（Branch）是一条独立的开发线。请永远为你的工作创建新分支，而不是直接在 develop 上提交。 Ang branch ay isang hiwalay na linya ng development. Laging gumawa ng bagong branch para sa iyong trabaho sa halip na mag-commit nang diretso sa develop.

Make sure you're on the latest develop branch first, then create a new branch: 先確保你在最新的 develop 分支，然後建立新分支： 先确保你在最新的 develop 分支，然后创建新分支： Siguraduhing nasa pinakabagong develop branch ka muna, pagkatapos gumawa ng bagong branch:

$ git checkout develop
$ git pull
$ git checkout -b feature/my-task

Common branch naming patterns: 常見的分支命名方式： 常见的分支命名方式： Mga karaniwang paraan ng pagpangalan ng branch:

• feature/add-login-page — new feature 新功能 新功能 bagong feature
• fix/broken-link — bug fix 修復 bug 修复 bug pag-aayos ng bug
• docs/update-readme — documentation change 文件修改 文档修改 pagbabago sa documentation

To check which branch you're currently on: 查看你目前在哪個分支： 查看你目前在哪个分支： Para i-check kung anong branch ka ngayon:

$ git branch
  develop
* feature/my-task

To switch between existing branches: 切換到已有的分支： 切换到已有的分支： Para lumipat sa ibang existing branch:

$ git checkout develop         # switch to develop
$ git checkout feature/my-task  # switch back

A commit saves a snapshot of your changes. Think of it like a checkpoint you can always go back to. Commit 會儲存你的修改快照，就像一個隨時可以回到的存檔點。 Commit 会保存你的修改快照，就像一个随时可以回到的存档点。 Ang commit ay nagse-save ng snapshot ng iyong mga pagbabago. Isipin mo itong checkpoint na pwede mong balikan anumang oras.

Step 1: Check what files you've changed: 步驟一：檢查你改了哪些檔案： 步骤一：检查你改了哪些文件： Step 1: I-check kung anong mga file ang nabago mo:

$ git status
On branch feature/my-task
Changes not staged for commit:
  modified:   src/index.html
Untracked files:
  src/new-file.js

Step 2: Stage the files you want to include in the commit: 步驟二：將要提交的檔案加入暫存區： 步骤二：将要提交的文件加入暂存区： Step 2: I-stage ang mga file na gusto mong isama sa commit:

$ git add src/index.html src/new-file.js  # add specific files

Step 3: Commit with a descriptive message: 步驟三：用描述性訊息來 commit： 步骤三：用描述性消息来 commit： Step 3: Mag-commit na may malinaw na message:

$ git commit -m "feat: add user login page"

Good commit messages describe what you changed and why: 好的 commit message 要描述你改了什麼和為什麼： 好的 commit message 要描述你改了什么和为什么： Ang magandang commit message ay naglalarawan kung ano ang binago at bakit:

• ✔ fix: prevent crash when user email is empty
• ✔ feat: add search filter for project list
• ✘ update
• ✘ fix stuff

Push uploads your commits from your computer to Gitea. Pull downloads the latest changes from Gitea to your computer. Push 將你的 commit 從電腦上傳到 Gitea。Pull 從 Gitea 下載最新的改動到你的電腦。 Push 将你的 commit 从电脑上传到 Gitea。Pull 从 Gitea 下载最新的改动到你的电脑。 Ang Push ay nag-a-upload ng iyong mga commit mula sa computer patungong Gitea. Ang Pull ay nagda-download ng pinakabagong mga pagbabago mula sa Gitea papunta sa iyong computer.

Push

After committing, push your branch to Gitea. The first time you push a new branch, use -u to set up tracking: Commit 之後，將你的分支推送到 Gitea。第一次推送新分支時，用 -u 建立追蹤關係： Commit 之后，将你的分支推送到 Gitea。第一次推送新分支时，用 -u 建立追踪关系： Pagkatapos mag-commit, i-push ang iyong branch sa Gitea. Sa unang beses na mag-push ng bagong branch, gamitin ang -u para i-setup ang tracking:

$ git push -u origin feature/my-task  # first push

After that, just git push is enough: 之後只需要 git push 就可以了： 之后只需要 git push 就可以了： Pagkatapos noon, git push lang ang kailangan:

$ git push

Pull

Before starting work each day, pull the latest changes to stay in sync: 每天開始工作前，先拉取最新的改動來保持同步： 每天开始工作前，先拉取最新的改动来保持同步： Bago magsimulang magtrabaho araw-araw, i-pull ang pinakabagong mga pagbabago para maka-sync:

$ git pull

To update your feature branch with the latest changes from develop: 要將 develop 的最新改動同步到你的功能分支： 要将 develop 的最新改动同步到你的功能分支： Para i-update ang iyong feature branch gamit ang pinakabagong mga pagbabago mula sa develop:

$ git checkout feature/my-task
$ git pull origin develop

Quick reference of the most common Git commands: 最常用的 Git 指令速查表： 最常用的 Git 命令速查表： Mabilis na reference ng pinaka-karaniwang Git commands:

Command 指令 命令 Command	What it does 作用 作用 Ano ang ginagawa
git clone <url>	Download a repository 下載一個 repository 下载一个仓库 I-download ang repository
git status	See what files have changed 查看哪些檔案有改動 查看哪些文件有改动 Tingnan kung anong mga file ang nabago
git add <file>	Stage a file for commit 將檔案加入暫存區 将文件加入暂存区 I-stage ang file para sa commit
git commit -m "msg"	Save staged changes with a message 儲存暫存區的改動並附上訊息 保存暂存区的改动并附上消息 I-save ang mga staged na pagbabago na may message
git push	Upload commits to Gitea 上傳 commit 到 Gitea 上传 commit 到 Gitea I-upload ang mga commit sa Gitea
git pull	Download latest changes from Gitea 從 Gitea 下載最新改動 从 Gitea 下载最新改动 I-download ang pinakabagong mga pagbabago mula sa Gitea
git branch	List all local branches 列出所有本地分支 列出所有本地分支 Ilista lahat ng local branches
git checkout <branch>	Switch to a branch 切換到某個分支 切换到某个分支 Lumipat sa isang branch
git checkout -b <name>	Create and switch to a new branch 建立新分支並切換過去 创建新分支并切换过去 Gumawa at lumipat sa bagong branch
git log --oneline	Show commit history (short) 顯示 commit 歷史（簡短） 显示 commit 历史（简短） Ipakita ang commit history (maikli)
git diff	Show unstaged changes 顯示未暫存的改動 显示未暂存的改动 Ipakita ang mga hindi pa na-stage na pagbabago