# 你的 GitHub 個人檔案 README 一次搞定：常用產生器與小工具（含範例可直接貼）
> [!NOTE]
> 📡 **本文包含多個動態統計圖片**，需要網路連線才能正常顯示預覽效果。
> 給開發者的超精簡實用指南：可以用幾個「一鍵產生器」先把版型生出來，再用常見小工具（統計卡、連擊、獎盃、程式時數、徽章、瀏覽計數）把內容補齊。
> 本文中所有示範一律使用本人帳號 **`thc1006`**，各位可以置換後直接複製貼上就能用。
## 一、先選一個「一鍵產生器」（輸入資料 → 自動組版）
* **GitHub Profile README Generator（Rahul Jain）**：超熱門的圖形化產生器，點一點就能輸出完整 Markdown，支援常見附加元件。使用：開啟網站 → 填基本資料與想要的卡片 → 匯出。 ([rahuldkjain.github.io][1])
* **GPRM（GitHub Profile ReadMe Maker）**：精簡導引式流程，主打「一分鐘內產出」。支援社群連結與統計卡快速插入。 ([gprm.itsvg.in][2])
* **Profilinator**：模組化拖拉組件，產生的 Markdown 可直接貼到 README。 ([Github Profilinator][3])
* **Profile Readme Generator（Mauro de Souza）**：另一路線的產生器，提供多種模板與左側選項面板。 ([Profile Readme Generator][4])
> 小提醒：以上工具的「自動選擇最合適版型」本質上就是你在精靈/表單勾選偏好（職能、技能、是否顯示統計卡…）後，系統幫你拼出適合的區塊與 Markdown。
---
## 二、把 README 變「會動」：經典小工具（即貼即用）
> 下面每個範例都已把 `username` 換成 **`thc1006`**，直接貼到你的 `README.md` 即可。
### 1) GitHub Readme Stats（總覽卡＋語言分佈）
```md
<!-- 總覽卡 -->
```
```
<!-- Top Languages（compact） -->
```
> <!-- 其他版型可試：layout=donut、donut-vertical、pie -->
參考專案與參數說明。 ([GitHub][5])
### 2) 連擊卡（Streak Stats）
```md
[](https://github.com/DenverCoder1/github-readme-streak-stats)
```
[](https://github.com/DenverCoder1/github-readme-streak-stats)
> **小技巧**：如果想把「私有倉庫的貢獻」也算進去，請到個人頁「貢獻圖」的選單開啟 *Private contributions*。工具的計算方式與注意事項見專案說明。 ([GitHub][6])
### 3) 獎盃牆（Profile Trophy）
```md
[](https://github.com/ryo-ma/github-profile-trophy)
```
[](https://github.com/ryo-ma/github-profile-trophy)
一行就能顯示動態獎盃，更多主題與排序可在專案頁找到。 ([GitHub][7])
### 4) 程式時數（WakaTime → 每週自動更新）
1. 申請並安裝 WakaTime（IDE 外掛）拿到 API Key。
2. 在你的「個人 README 倉庫」加上 GitHub Actions（依市集頁教學設定）。
3. 在 README 放入以下註記，Action 會定期把統計寫進來：
```md
<!--START_SECTION:waka-->
<!--END_SECTION:waka-->
```
設定方式與 Action 市集頁： ([GitHub][8])
---
## 三、常用徽章 & 訪客計數
### 1) Shields.io 徽章（技能、社群、版本…）
```md
<!-- 例：LinkedIn、Gmail、Python 技能徽章 -->
[](#)
[](#)
```
徽章產生器與完整文件（可換主題/Logo/顏色）： ([Shields][9])
更多現成樣式清單： ([ileriayo.github.io][10])
### 2) 個人頁瀏覽次數（ghpvc）
```md
```
官方使用說明與範例： ([GitHub][11])
---
## 四、快速上線（3 步驟）
1. 在 GitHub 建立一個**和你帳號同名**的公開倉庫（例如：`thc1006/thc1006`）。
2. 新增/編輯根目錄的 `README.md`，把上面範例貼上即可。
3. 儲存後回到你的個人頁，README 就會顯示在最上方。 ([GitHub Docs][12])
---
## 五、延伸閱讀（範例大全）
* **Awesome GitHub Profile README**：大量範例與工具彙整，靈感一次看。 ([GitHub][13])
---
### 最小可用片段（直接貼到你的 `README.md`）
```md
# Hi, I'm Hsiu-Chi (thc1006)
[](#)
[](#)
## GitHub Stats
## Streak
[](https://github.com/DenverCoder1/github-readme-streak-stats)
## Trophies
[](https://github.com/ryo-ma/github-profile-trophy)
## Coding Time (WakaTime)
<!--START_SECTION:waka-->
<!--END_SECTION:waka-->
```
[1]: https://rahuldkjain.github.io/gh-profile-readme-generator/ "GitHub Profile Readme Generator - Rahul Jain"
[2]: https://gprm.itsvg.in/ "GPRM : GitHub Profile ReadMe Maker"
[3]: https://profilinator.rishav.dev/ "Github Profilinator - GitHub Profile README Generator"
[4]: https://profile-readme-generator.com/ "Profile Readme Generator"
[5]: https://github.com/anuraghazra/github-readme-stats "anuraghazra/github-readme-stats"
[6]: https://github.com/DenverCoder1/github-readme-streak-stats "DenverCoder1/github-readme-streak-stats"
[7]: https://github.com/ryo-ma/github-profile-trophy "ryo-ma/github-profile-trophy"
[8]: https://github.com/marketplace/actions/waka-readme "Waka Readme · Actions · GitHub Marketplace"
[9]: https://shields.io/ "Shields.io"
[10]: https://ileriayo.github.io/markdown-badges/ "markdown-badges - GitHub Pages"
[11]: https://github.com/antonkomarev/github-profile-views-counter "antonkomarev/github-profile-views-counter"
[12]: https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme "Managing your profile README"
[13]: https://github.com/abhisheknaiidu/awesome-github-profile-readme "abhisheknaiidu/awesome-github-profile-readme"
Sign in via Google
Sign in via Facebook
Sign in via X(Twitter)
Sign in via GitHub
Sign in via Dropbox
Sign in with Wallet
Connect another wallet