本文介绍如何利用 music21 的 scale 类精准生成 c 大调（c ionian）自然音阶中的音符，确保输出仅包含 c、d、e、f、g、a、b 及其跨八度的等价音高（如 c4、d5、b3），完全避免升降号音符，并支持自定义 midi 音高范围。
本文介绍如何利用 music21 的 scale 类精准生成 c 大调（c ionian）自然音阶中的音符，确保输出仅包含 c、d、e、f、g、a、b 及其跨八度的等价音高（如 c4、d5、b3），完全避免升降号音符，并支持自定义 midi 音高范围。
原始代码的问题核心在于：n.pitch.midi = random.randint(min_pitch, max_pitch) 直接强制设置 MIDI 值，会覆盖 n.name 所定义的自然音名，导致音高虽在范围内，但可能映射为带升降号的等效音（例如 MIDI 61 → C♯4），从而破坏调性纯度。
正确做法是先构建 C 大调音阶，再在其合法音高范围内采样。music21 提供了 scale.ConcreteScale（适用于自定义音级）和更推荐的 scale.MajorScale('C')，二者均可通过 getPitches() 方法获取指定音域内所有符合调性的 Pitch 对象列表。
以下是优化后的完整实现：
from music21 import stream, note, scale, pitch
def generate_c_major_diatonic_notes(
num_notes: int,
min_midi: int = 60, # C4 = 60
max_midi: int = 80 # G5 = 79, A5 = 80
) -> stream.Stream:
s = stream.Stream()
# 创建 C 大调音阶（推荐使用内置 MajorScale，语义清晰且自动处理调号）
c_major_scale = scale.MajorScale('C')
# 获取指定 MIDI 范围内所有 C 大调自然音（含跨八度重复）
# getPitches() 接受两个 Pitch 对象作为边界（支持 MIDI 值或字符串如 'C4'）
low_p = pitch.Pitch()
low_p.midi = min_midi
high_p = pitch.Pitch()
high_p.midi = max_midi
all_diatonic_pitches = c_major_scale.getPitches(low_p, high_p)
# 随机采样（允许重复；如需不重复可用 random.sample）
import random
selected_pitches = [random.choice(all_diatonic_pitches) for _ in range(num_notes)]
for p in selected_pitches:
n = note.Note(p)
n.duration = note.Duration('eighth')
s.append(n)
return s
# 示例：生成 20 个 C 大调自然音，MIDI 范围 60–80（C4–A5）
diatonic_stream = generate_c_major_diatonic_notes(num_notes=20, min_midi=60, max_midi=80)
diatonic_stream.show('text') # 查看音符序列（如 C4, E4, G4, C5...）✅ 关键优势：
- 所有生成音符均为纯自然音（无 #/♭），严格符合 C 大调音阶结构；
- getPitches() 自动处理跨八度扩展，例如在 60–80 范围内返回 C4、D4、E4、F4、G4、A4、B4、C5、D5、E5、F5、G5、A5 共 13 个合法音；
- 避免手动拼接音名与 MIDI 值的逻辑错误，提升可读性与鲁棒性。
⚠️ 注意事项：
- 若需限定音名（如仅生成 C4–B4 八度内音），请将 low_p 和 high_p 设为 'C4' 和 'B4' 字符串，而非 MIDI 值；
- scale.ConcreteScale(pitches=['C','D','E','F','G','A','B']) 功能等效，但 MajorScale('C') 更具语义明确性，且兼容调号推导（如 .getScaleDegreeFromPitch()）；
- 如需导出为 MIDI 文件：diatonic_stream.write('midi', fp='c_major_random.mid')。
通过该方法，你可稳定、可复现地生成符合调性约束的随机旋律素材，适用于算法作曲、音乐教育或音高统计实验等场景。
