mhhung/coding-practice
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(utils, templates, docs): file-based templates + stronger README

Browse Source
This commit is contained in:
MH Hung
2025-09-12 09:44:30 +08:00
parent 002e9e6c32
commit d724a5fb65
35 changed files with 1421 additions and 727 deletions
Download Patch File Download Diff File Expand all files Collapse all files

86
templates/logs-template.md
View File

@@ -1,86 +0,0 @@
# 2025年8月 學習記錄
## 📅 每日練習記錄
### Week 1 (2025-08-01 ~ 2025-08-07)
| 日期 | 題目 | 難度 | 語言 | 耗時 | 狀態 | 心得 |
|------|------|------|------|------|------|------|
| 08-01 | [1] Two Sum | Easy | C# | 30min | ✅ | 第一題，熟悉環境 |
| 08-02 | [1] Two Sum | Easy | Go | 45min | ✅ | Go語法不熟，多花時間 |
| 08-03 | [15] 3Sum | Medium | C# | 90min | ⚠️ | TLE，需要最佳化 |
| 08-04 | [15] 3Sum | Medium | C# | 60min | ✅ | 學會雙指針，重要突破！ |
| 08-05 | 休息 | - | - | - | - | 週末休息 |
| 08-06 | [11] Container Water | Medium | C# | 45min | ✅ | 雙指針再次應用 |
| 08-07 | 複習筆記 | - | - | 60min | - | 整理本週學習 |
### Week 2 (2025-08-08 ~ 2025-08-14)
| 日期 | 題目 | 難度 | 語言 | 耗時 | 狀態 | 心得 |
|------|------|------|------|------|------|------|
| 08-08 | [3] Longest Substring | Medium | C# | 120min | 🔄 | 滑動窗口概念很重要 |
| 08-09 | [3] Longest Substring | Medium | Go | 90min | ✅ | Go實作更簡潔 |
| ... | ... | ... | ... | ... | ... | ... |
## 📈 本月統計
### 完成情況
- **總練習天數**: 20天
- **完成題數**: 8題
- **語言分布**: C# (8題), Go (5題)
- **難度分布**: Easy (5題), Medium (3題), Hard (0題)
### 時間投入
- **總時間**: 18小時
- **平均每題**: 135分鐘
- **每日平均**: 54分鐘
### 正確率
- **一次通過**: 3題 (37.5%)
- **二次通過**: 4題 (50%)
- **多次調整**: 1題 (12.5%)
## 🎯 本月重點學習
### 新掌握的技巧
1. **雙指針技巧** - 在 3Sum 和 Container Water 中應用
2. **Hash Table 應用** - Two Sum 的經典解法
3. **滑動窗口初步** - Longest Substring 問題
### 常犯錯誤分析
1. **邊界條件** - 忘記檢查空陣列 (犯錯 3次)
2. **索引越界** - 雙指針移動時的邊界 (犯錯 2次)
3. **時間複雜度** - 第一次嘗試常用暴力解法
### 語言學習心得
- **C#**: 語法熟悉，LINQ很好用但要注意效能
- **Go**: 簡潔但型別嚴格，slice操作需多練習
## 🔄 遇到的困難與解決
### 困難1: 思路卡住
- **問題**: 3Sum 一開始完全沒思路
- **解決**: 先研究 Two Sum，再擴展到三個數字
- **學習**: 從簡單問題推廣到複雜問題
### 困難2: Go語法不熟
- **問題**: Go的slice、map語法經常出錯
- **解決**: 整理了Go語法筆記，多做練習
- **學習**: 不要急著解題，先把工具準備好
## 📝 改進計畫
### 9月目標
1. **提升難度**: 嘗試3-5題Hard題目
2. **新主題**: 開始學習動態規劃
3. **效率提升**: 目標平均解題時間降到90分鐘
4. **語言平衡**: Go語言題數追上C#
### 學習方法調整
1. **題目分析時間**: 每題先花15分鐘分析再開始寫程式
2. **複習機制**: 每週末複習本週所有題目
3. **筆記改善**: 加強解題思路的記錄
## 💡 本月金句
> "演算法不是背出來的，是理解出來的" - 在第15題3Sum卡住兩天後的感悟
---
**總結**: 八月是很好的開始，從完全新手到能獨立解決中等題目。九月要持續挑戰自己！

99
templates/logs-template.md.tmpl Normal file
View File

@@ -0,0 +1,99 @@
# YYYY年M月 學習記錄
## 本月設定（目標與主題）
- 主題：雙指針 / 滑動視窗 / DP / 圖論（自訂）
- 目標題數：X 題（Easy Y / Medium Z / Hard W）
- 投入時間：每日 ≥ N 分鐘；每週 ≥ M 小時
- 挑戰：至少完成 Hard ≥ H 題；每週寫 1 篇總結
## 📅 每日練習記錄
### Week 1 (YYYY-MM-DD ~ YYYY-MM-DD)
| 日期 | 題目 | 難度 | 語言 | 耗時 | 狀態 | 心得 |
|------|------|------|------|------|------|------|
| | | | | | | |
### Week 2 (YYYY-MM-DD ~ YYYY-MM-DD)
| 日期 | 題目 | 難度 | 語言 | 耗時 | 狀態 | 心得 |
|------|------|------|------|------|------|------|
| | | | | | | |
### Week 3 (YYYY-MM-DD ~ YYYY-MM-DD)
| 日期 | 題目 | 難度 | 語言 | 耗時 | 狀態 | 心得 |
|------|------|------|------|------|------|------|
| | | | | | | |
### Week 4 (YYYY-MM-DD ~ YYYY-MM-DD)
| 日期 | 題目 | 難度 | 語言 | 耗時 | 狀態 | 心得 |
|------|------|------|------|------|------|------|
| | | | | | | |
## 🧭 主題覆蓋追蹤（勾選）
- [ ] 陣列/字串（Two Pointers / Sliding Window）
- [ ] 資料結構（Stack/Queue/Heap/Set/Map）
- [ ] 排序與搜尋（Sorting / Binary Search）
- [ ] 數學與位運算（Math / Bit）
- [ ] 動態規劃（DP）
- [ ] 圖論（BFS/DFS/最短路/拓撲）
- [ ] 樹（BST/遍歷/序列化）
## 📈 本月統計
### 完成情況
- 練習天數：天
- 完成題數：題（Easy / Medium / Hard）
- 語言分布：C# (題), Go (題)
- 連續天數（Streak）：天；本月斷點：第 天
### 時間投入
- 總時間：小時
- 平均每題：分鐘
- 每日平均：分鐘
### 正確率 / 嘗試次數
- 一次通過：題
- 二次通過：題
- 多次調整：題（主因：邊界/複雜度/實作）
## 🎯 本月重點學習
### 新掌握的技巧（至少 3 條）
1.
2.
3.
### 常見錯誤與對策
1. 錯誤：；對策：
2. 錯誤：；對策：
3. 錯誤：；對策：
### 語言心得（實作層面）
- C#：LINQ/Span/效能注意點/測試習慣
- Go：slice/map/指標/錯誤處理/benchmark 習慣
## 🔄 困難案例復盤
### 案例1：題號/主題
- 問題：
- 嘗試：
- 解決：
- 學習：
### 案例2：題號/主題
- 問題：
- 嘗試：
- 解決：
- 學習：
## 📝 下月計畫
- 目標題數：
- 重點主題：
- 練習節奏：
- 要避免的坑：
## 💡 本月金句
>
---
**總結**：本月最大收穫是 ______，接下來專注 ______。

73
templates/problem-template.md
View File

@@ -1,73 +0,0 @@
# [題目編號] 題目名稱
## 題目資訊
- **難度**: Easy/Medium/Hard
- **標籤**: Array, Hash Table, Two Pointers, etc.
- **題目連結**: [LeetCode](https://leetcode.com/problems/xxx/)
- **練習日期**: YYYY-MM-DD
## 題目描述
> 在這裡貼上題目的完整描述
## 解題思路
### 初步分析
- 這題主要考察什麼概念？
- 有什麼關鍵限制條件？
- 預期時間/空間複雜度？
### 解法概述
1. **暴力解法**:
- 思路：
- 時間複雜度：O(?)
- 空間複雜度：O(?)
2. **優化解法**:
- 思路：
- 時間複雜度：O(?)
- 空間複雜度：O(?)
## 實作細節
### C# 解法
```csharp
// 核心程式碼片段或關鍵邏輯說明
```
### Go 解法
```go
// 核心程式碼片段或關鍵邏輯說明
```
## 測試案例
### 範例輸入輸出
```
Input:
Output:
Explanation:
```
### 邊界情況
- [ ] 空陣列/空字串
- [ ] 單一元素
- [ ] 最大/最小值
- [ ] 重複元素
## 學習筆記
### 今天學到什麼？
-
### 遇到的困難
-
### 改善方向
-
### 相關題目
- [題目編號] 題目名稱 - 相似概念
- [題目編號] 題目名稱 - 進階版本
---
**總結**: 這題的核心概念是...，適合練習...技巧。

105
templates/problem-template.md.tmpl Normal file
View File

@@ -0,0 +1,105 @@
# [題目編號] 題目名稱
## 題目資訊
- **難度**: Easy/Medium/Hard
- **標籤**: Array, Hash Table, Two Pointers, Sliding Window, Greedy, DP, Graph, Tree, Math, etc.
- **題目連結**: [LeetCode](https://leetcode.com/problems/xxx/)
- **練習日期**: YYYY-MM-DD
- **目標複雜度**: 時間 O(?), 空間 O(?)
## 題目描述
> 在這裡貼上題目的完整描述（或摘要）
## 先備條件與限制
- 輸入限制：n ∈ [?, ?]、值域 ∈ [?, ?]、是否有重複、是否有負數/零
- 回傳/輸出格式：...
- 其他：排序是否允許改變輸入、是否需穩定、是否需就地（in-place）
## 解題思路
### 初步分析（快速定位問題類型）
- 問題類型：如 雙指針 / 滑動視窗 / 排序 + 掃描 / 貪心 / DP / 單調結構 / 前綴和 / 二分 / 位運算 ...
- 關鍵觀察：列出 2-4 點（不等式關係、單調性、區間性質、可分解性）
- 目標複雜度理由：為什麼 O(n) 或 O(n log n) 足夠/必要？
### 解法比較
1. **解法 A（基準/暴力/直接枚舉）**
- 思路：步驟 1-2-3
- 正確性：為什麼不會漏/不會重？
- 複雜度：時間 O(?)、空間 O(?)
- 優缺點：易寫/慢；好理解/不通過大資料
2. **解法 B（優化：排序/雙指針/結構）**
- 思路：步驟 1-2-3（指出與解法 A 最大差異）
- 正確性：單調性/貪心選擇/狀態定義 的論證要點
- 複雜度：時間 O(?)、空間 O(?)
- 優缺點：通過大資料/實作較複雜；可讀性需注意
3. （可選）**解法 C（進一步優化/其他路線）**
- 思路、正確性、複雜度、優缺點
### 乾跑（Dry Run）
使用一組小範例逐步展示索引/指標/狀態如何變化（建議附上 3-5 步驟）。
## 實作細節與 API 設計
### C# 方法簽名
```csharp
public class Solution {
// TODO: 根據題意調整簽名
public int Solve(int[] nums) {
// ...
}
}
```
### Go 方法簽名
```go
// TODO: 根據題意調整簽名
func solve(nums []int) int {
// ...
}
```
### 實作要點 / 常見陷阱
- 邊界：空集合、單元素、全相等、極值（INT_MIN/INT_MAX）
- 去重：排序後跳重複、集合/哈希去重
- 早停：提早終止條件（例如 window 擴不動就停）
- 精度/溢位：除法、乘法、64 位整數
## 測試案例
### 範例輸入輸出
```
Input: ...
Output: ...
Explanation: ...
```
### 邊界與特殊情況清單
- [ ] 空陣列/空字串
- [ ] 單一元素 / 全相同 / 全遞增 / 全遞減
- [ ] 含負數 / 含 0 / 大數
- [ ] 有重複值 / 需去重
- [ ] 大資料壓力測試（n 接近上限）
### 對拍/隨機測試（可選）
- 與暴力解法對拍 1000 次；隨機生成測資，確保輸出一致
## 複雜度分析
- 最壞：時間 O(?)、空間 O(?)
- 平均：時間 O(?)
- 最佳：時間 O(?)（若有）
## 相關題目與 Follow-up
- [題目編號] 題目名稱（相同套路）
- Follow-up：若輸入動態變化/資料流版本/線上查詢如何處理？
## 學習筆記
- 今天學到：
- 卡住點與修正：
- 下次優化想法：
---
**總結**：這題的核心在於 ______，適合練習 ______ 技巧。

91
templates/problem/README.md.tmpl Normal file
View File

@@ -0,0 +1,91 @@
# [{{NUMBER}}] {{NAME_TITLE}}
## 題目資訊
- **難度**: {{DIFFICULTY}}
- **標籤**:
- **題目連結**: https://leetcode.com/problems/{{NAME_SLUG}}/
- **練習日期**: {{DATE}}
- **目標複雜度**: 時間 O(?)、空間 O(?)
## 題目描述
> 在這裡貼上題目的完整描述（或重點）
## 先備條件與限制
- 輸入限制：n ∈ [?, ?]、值域 ∈ [?, ?]
- 回傳/輸出格式：...
- 其他：是否允許排序/就地修改
## 解題思路
### 初步分析
- 類型：雙指針 / 滑動視窗 / 排序 / DP / 貪心 / 圖論 ...
- 關鍵觀察：
- 複雜度目標理由：
### 解法比較
1. 解法A（基準/暴力）：
- 思路：
- 正確性：
- 複雜度：O(?) / O(?)
2. 解法B（優化）：
- 思路：
- 正確性：
- 複雜度：O(?) / O(?)
### 乾跑（Dry Run）
- 範例：...
## 實作細節與 API 設計
### C# 方法簽名（示意）
```csharp
public class Solution {
// TODO: 根據題意調整簽名
public int Solve(int[] nums) {
return 0;
}
}
```
### Go 方法簽名（示意）
```go
func solve(nums []int) int {
return 0
}
```
### 常見陷阱
- 邊界：空/單一/極值/全相等
- 去重：排序後跳重複、集合
- 溢位：使用 64-bit
## 測試案例
### 範例輸入輸出
```
Input: ...
Output: ...
Explanation: ...
```
### 邊界清單
- [ ] 空陣列/空字串
- [ ] 單一元素 / 全相同
- [ ] 含負數/0/大數
- [ ] 去重
- [ ] 大資料壓力
## 複雜度分析
- 最壞：時間 O(?)、空間 O(?)
## 相關題目 / Follow-up
-
## 學習筆記
- 今天學到：
- 卡住與修正：
- 待優化：
---
**總結**：這題的核心在於 ______，適合練習 ______。

24
templates/problem/csharp/Program.cs.tmpl Normal file
View File

@@ -0,0 +1,24 @@
// LeetCode {{NUMBER}}: {{NAME_TITLE}}
// 難度: {{DIFFICULTY}}
// 日期: {{DATE}}
using System;
using System.Collections.Generic;
using System.Linq;
public class Solution {
// TODO: 根據題意調整簽名
public int Solve(int[] nums) {
// 實作解法
return 0;
}
}
public class Program {
public static void Main() {
var s = new Solution();
// TODO: 可加入簡單輸入/輸出測試
Console.WriteLine("Hello LeetCode {{NUMBER}}!");
}
}

9
templates/problem/csharp/csharp.csproj.tmpl Normal file
View File

@@ -0,0 +1,9 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net8.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
</Project>

18
templates/problem/go/main.go.tmpl Normal file
View File

@@ -0,0 +1,18 @@
// LeetCode {{NUMBER}}: {{NAME_TITLE}}
// 難度: {{DIFFICULTY}}
// 日期: {{DATE}}
package main
import "fmt"
// TODO: 根據題意調整簽名
func solve(nums []int) int {
return 0
}
func main() {
fmt.Printf("Hello LeetCode {{NUMBER}}!\n")
// TODO: 可加入簡單測試
}

24
templates/problem/test/SolutionTests.cs.tmpl Normal file
View File

@@ -0,0 +1,24 @@
// LeetCode {{NUMBER}} 單元測試（xUnit）
using Xunit;
public class SolutionTests {
private readonly Solution _s = new Solution();
[Fact]
public void Example1() {
// TODO: Arrange
// var input = new int[] { };
// var expected = 0;
// Act
// var got = _s.Solve(input);
// Assert.Equal(expected, got);
Assert.True(true);
}
[Fact]
public void EdgeCases() {
Assert.True(true);
}
}

19
templates/problem/test/TestProject.csproj.tmpl Normal file
View File

@@ -0,0 +1,19 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<Nullable>enable</Nullable>
<IsPackable>false</IsPackable>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.1.0" />
<PackageReference Include="xunit" Version="2.4.1" />
<PackageReference Include="xunit.runner.visualstudio" Version="2.4.3">
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
<PrivateAssets>all</PrivateAssets>
</PackageReference>
</ItemGroup>
<ItemGroup>
<ProjectReference Include="../csharp/csharp.csproj" />
</ItemGroup>
</Project>

20
templates/problem/test/edge_cases.md.tmpl Normal file
View File

@@ -0,0 +1,20 @@
# 邊界情況清單（{{NUMBER}} {{NAME_TITLE}}）
## 需要測試的邊界
- [ ] 空輸入 / 單一元素
- [ ] 重複元素 / 全相同
- [ ] 極值（最小/最大）
- [ ] 含負數 / 0 / 大數
- [ ] 大資料量（接近上限）
## 額外案例
### 案例 1
- 輸入：
- 預期：
- 說明：
### 案例 2
- 輸入：
- 預期：
- 說明：

2
templates/problem/test/input1.txt.tmpl Normal file
View File

@@ -0,0 +1,2 @@
# 測試案例 1 輸入（{{NUMBER}} {{NAME_TITLE}}）

2
templates/problem/test/input2.txt.tmpl Normal file
View File

@@ -0,0 +1,2 @@
# 測試案例 2 輸入（{{NUMBER}} {{NAME_TITLE}}）

12
templates/problem/test/main_test.go.tmpl Normal file
View File

@@ -0,0 +1,12 @@
// LeetCode {{NUMBER}} 單元測試（Go testing）
package main
import "testing"
func TestExample(t *testing.T) {
// TODO: input := []int{}
// got := solve(input)
// want := 0
// if got != want { t.Fatalf("want %v got %v", want, got) }
}

2
templates/problem/test/output1.txt.tmpl Normal file
View File

@@ -0,0 +1,2 @@
# 測試案例 1 期望輸出（{{NUMBER}} {{NAME_TITLE}}）

2
templates/problem/test/output2.txt.tmpl Normal file
View File

@@ -0,0 +1,2 @@
# 測試案例 2 期望輸出（{{NUMBER}} {{NAME_TITLE}}）

36
templates/problem/test/run_tests.sh.tmpl Normal file
View File

@@ -0,0 +1,36 @@
#!/bin/bash
set -e
echo "🧪 執行測試: {{NUMBER_PAD}}-{{NAME_SLUG}}"
echo "=========================="
pushd "$(dirname "$0")" >/dev/null
echo "📋 C# 測試結果:"
if (cd ../csharp && dotnet build >/dev/null 2>&1); then
if dotnet test --logger "console;verbosity=minimal" >/dev/null 2>&1; then
echo "✅ C# 測試通過"
else
echo "❌ C# 測試失敗"
fi
else
echo "❌ C# 編譯失敗"
fi
echo ""
echo "📋 Go 測試結果:"
if (cd ../go && go build >/dev/null 2>&1); then
if go test -v >/dev/null 2>&1; then
echo "✅ Go 測試通過"
else
echo "❌ Go 測試失敗（顯示詳細）"
go test -v
fi
else
echo "❌ Go 編譯失敗"
fi
popd >/dev/null
echo ""
echo "📊 測試完成！"