如何通过Python调用Lilypond API而非可执行文件生成乐谱PDF？

嗨，我来帮你搞定这个问题！首先得明确：Lilypond官方并没有提供正式的Python API，但咱们有两种靠谱的纯Python方案，完全不用通过subprocess这类调用系统命令的方式来生成PDF：

方案1：用python-ly库（推荐，上手简单） #

python-ly是专门为Lilypond打造的Python工具库，它封装了Lilypond的核心功能，能直接通过Python接口处理乐谱生成，底层虽然依赖你系统里装的Lilypond，但全程不用手动敲命令行。

先装库 #

打开终端跑这个命令：

pip install python-ly

示例代码 #

下面是个极简示例，直接在Python里生成PDF：

import ly.document
import ly.publisher

# 写一段Lilypond格式的乐谱代码
lilypond_score = """
\\score {
  \\new Staff {
    c'4 d' e' f' g' a' b' c''  % 一段简单的上行音阶
  }
  \\layout {}
  \\midi {}
}
"""

# 创建Lilypond文档对象
score_doc = ly.document.Document(lilypond_score)

# 配置发布器：指定输出格式为PDF，以及输出路径
pdf_publisher = ly.publisher.Publisher()
pdf_publisher.set_output_format("pdf")
pdf_publisher.set_output_path("./my_scale.pdf")

# 生成PDF！
pdf_publisher.publish(score_doc)

运行这段代码后，你就能在当前目录拿到my_scale.pdf文件了，全程没有系统命令调用，纯Python接口搞定。

方案2：直接调用Lilypond的Scheme接口（进阶玩法） #

Lilypond本身是用Scheme语言开发的，如果你懂点Scheme，可以通过Python的guile绑定直接调用Lilypond的内部核心函数。这种方式更底层，但门槛稍高，适合有进阶需求的开发者。

先装依赖 #

先装python-guile：

pip install python-guile

示例代码 #

import guile

# 加载Lilypond的Scheme核心模块
guile.eval("(use-modules (lily))")

# 定义乐谱代码
lilypond_code = """
\\score {
  \\new Staff {
    c'4 e' g' c''  % 一个C大三和弦
  }
}
"""

# 调用Scheme函数直接生成PDF
guile.eval(f'(ly:export (ly:parse-string "{lilypond_code}") "./chord.pdf")')

这种方式完全绕过了命令行，直接和Lilypond的核心逻辑交互，但需要你懂点Scheme的基础语法，不然调试起来会有点头疼。

小提醒 #

不管用哪种方案，你得先在系统里装好Lilypond本体——这些Python库都是依托Lilypond的核心功能来生成PDF的，没有它可不行哦。如果遇到依赖问题，可以看看python-ly的本地文档（用pip show python-ly能找到相关路径）来排查。

内容的提问来源于stack exchange，提问作者Matthew Moisen