# ABC记谱法语法标准

## 基本结构

```
X:1                    % 曲谱编号（必需）
T:曲目名称              % 标题（必需）
C:作者                  % 作者
M:4/4                  % 节拍（必需）
L:1/4                  % 默认音长（四分音符）
Q:120                  % 速度（每分钟拍数）
K:C                    % 调性（必需）
% —————— 正文 ——————
C D E F G A B |
```

| 头字段 | 说明 | 必填 |
|:-------|:-----|:----:|
| `X:` | 曲谱编号 | 是 |
| `T:` | 曲目标题 | 是 |
| `M:` | 节拍，如 `4/4`、`3/4`、`6/8` | 是 |
| `L:` | 默认音长，如 `1/4`（四分音符） | 推荐 |
| `Q:` | 速度，如 `120`（每分钟拍数） | 推荐 |
| `K:` | 调性，如 `C`大调、`Am`小调 | 是 |
| `C:` | 作者/作曲者 | 否 |
| `R:` | 曲式/节奏类型 | 否 |
| `O:` | 起源/地区 | 否 |
| `S:` | 来源 | 否 |
| `N:` | 注释 | 否 |

## 音高

| 写法 | 音域 |
|:-----|:-----|
| `C D E F G A B` | 中音（大字组） |
| `c d e f g a b` | 高八度（小字一组） |
| `c' d' e' f' g' a' b'` | 再高八度（小字二组） |
| `C, D, E, F, G, A, B,` | 低八度（大字一组） |

## 音长

默认音长由 `L:` 设定，数字后缀表示倍数：

| 写法 | 音长 |
|:-----|:-----|
| `C` | 1倍默认音长 |
| `C2` | 2倍（二分音符） |
| `C3` | 3倍（附点二分音符） |
| `C/2` | 1/2（八分音符） |
| `C/4` | 1/4（十六分音符） |
| `C3/2` | 3/2（附点四分音符） |

## 常用元素

| 语法 | 含义 | 示例 |
|:-----|:-----|:-----|
| `C D E F` | 单音序列 | `C D E F G A B` |
| `[CEG]` | 和弦（同时发声） | `[CEG]` 表示C大三和弦 |
| `z` | 休止符 | `z2` 表示两拍休止 |
| `\|` | 小节线 | `C D E F \| G A B c \|` |
| `\|\|` | 双小节线（段落结束） | |
| `\|:]` | 重复结束 | |
| `[:\|` | 重复开始 | |
| `!trill!` | 装饰音/颤音 | `!trill!C` |
| `"text"` | 歌词/文字标注 | `"啊"C "你"D` |

## 调性对照

| 写法 | 调性 |
|:-----|:-----|
| `K:C` | C大调 |
| `K:G` | G大调 |
| `K:D` | D大调 |
| `K:Am` | A小调 |
| `K:Em` | E小调 |
| `K:Dm` | D小调 |

## 节拍示例

| 写法 | 含义 |
|:-----|:-----|
| `M:4/4` | 四四拍（每小节4个四分音符） |
| `M:3/4` | 四三拍（每小节3个四分音符） |
| `M:6/8` | 八六拍（每小节6个八分音符） |
| `M:2/2` | 二二拍（每小节2个二分音符） |

## 完整示例

```
X:1
T:小星星
C:莫扎特
M:4/4
L:1/4
Q:120
K:C
C C G G | A A G2 |
F F E E | D D C2 |
```

## 禁止行为
- ❌ 禁止缺少 `X:`、`T:`、`M:`、`K:` 必需头字段
- ❌ 禁止使用非标准ABC扩展语法（不同解析器实现有差异）