本文介绍如何利用模运算实现列表中任意元素向后偏移 n 位的动态访问，特别适用于音乐理论中音阶度数计算——给定主音，快速查得其上方小二度、大二度等对应音符，自动处理循环越界（如 b 向上两度得 c#）。
本文介绍如何利用模运算实现列表中任意元素向后偏移 n 位的动态访问，特别适用于音乐理论中音阶度数计算——给定主音，快速查得其上方小二度、大二度等对应音符，自动处理循环越界（如 b 向上两度得 c#）。
在音乐理论编程中，一个核心需求是：给定主音（key center），动态推导其各调式音级（scale degrees）所对应的音名。例如，C 主音的“2”（大二度）是 D，“m2”（小二度）是 C#；而 B 主音的“2”应为 C#（因 B→C→C#，向上两步）。这本质上是一个循环列表索引问题：需从目标元素出发，向右移动固定步数，并在到达末尾时自动折返至开头。
关键在于两点：
-
去重标准化：原始列表中
C#和Db等属同音异名（enharmonic equivalents），不可并存于同一音高定位体系中。应保留唯一标准记法（如统一用#表示升号，或统一用b表示降号），构建 12 音等程律标准序列； -
模运算索引：使用
(current_index + offset) % 12实现安全循环偏移，避免IndexError，天然支持跨八度计算。
以下是完整可运行的实现：
# 标准化12音半音阶（升号体系，无重复）
chromatic_notes = ["A", "A#", "B", "C", "C#", "D", "D#", "E", "F", "F#", "G", "G#"]
# 对应音级名称（按十二平均律顺序定义）
scale_degrees = ["1", "m2", "2", "m3", "3", "4", "m5", "5", "m6", "6", "m7", "7"]
def get_degrees(key_center):
"""根据主音返回所有音级映射字典"""
try:
base_idx = chromatic_notes.index(key_center)
except ValueError:
raise ValueError(f"'{key_center}' not found in chromatic scale. Use standard notation (e.g., 'C#', not 'Db').")
# 计算每个音级偏移后的音符：(base_idx + offset) % 12
shifted_notes = [
chromatic_notes[(base_idx + i) % len(chromatic_notes)]
for i in range(len(scale_degrees))
]
return dict(zip(scale_degrees, shifted_notes))
# 示例调用
print(get_degrees("C")) # {'1': 'C', 'm2': 'C#', '2': 'D', ...}
print(get_degrees("B")["2"]) # 'C#'（B→C→C#，两步）
print(get_degrees("G")["4"]) # 'C'（G→G#→A→A#→B→C，四步）
✅ 注意事项：
- 输入主音必须严格匹配
chromatic_notes中的字符串（如"C#"✅，"Db"❌），否则抛出明确异常； - 偏移量由
scale_degrees的顺序隐式定义：索引0对应"1"，索引1对应"m2"，依此类推； - 若需支持降号体系（如
Ab,Bb），只需替换chromatic_notes为["A", "Bb", "B", "C", "Db", "D", "Eb", "E", "F", "Gb", "G", "Ab"]，其余逻辑完全复用； - 此设计具备扩展性：后续添加调式（如多利亚、弗里几亚）仅需定义新
scale_degrees列表并复用get_degrees()。
该方案摒弃了硬编码 12 个独立字典的冗余做法，以数学化的模运算为核心，简洁、健壮且符合音乐理论底层逻辑。
