Edge-TTS：微软推出的，免费、开源、支持多种中文语音语色的AI工具[工具版]

要把中文文本转成自然语音，很多人第一反应是找在线合成网站，结果要么有字数限制，要么导出带水印。微软的 edge-tts 是把 Edge 浏览器里那套在线朗读接口封装成命令行/Python 库的项目，免费、开源、支持多国语言与多种中文音色，本地命令行就能批量出 mp3。本文记录在 WSL2 环境里用 pipx 安装 edge-tts 并生成音频的完整过程，顺带说明 pipx 这类工具是干什么用的。

Edge-TTS 是什么

edge-tts 不是一个独立的大软件，它是把微软在线语音合成服务（Edge 的朗读能力）封装成一个 Python 包，对外提供命令行与程序接口：

• 音色多：官方提供了几十种声音，中文有女声（如 Xiaoxiao、Xiaoyi、Xiaochen）和男声（Yunxi、Yunjian 等）等不同语气的选项，可指定语速、音调。
• 输出格式：直接生成 mp3 音频文件（--write-media），也可以只输出音频流给程序实时播放。
• 场景：智能助手语音、课程/培训音频、视频配音、无障碍朗读、批量生成播报语音。

需要注意：它依赖的是微软在线服务的接口，不是本地离线模型，所以运行时需要能连到微软的域名，在内网或受限网络下要评估可用性；音色列表会随官方调整而变化，实际可用名单以 edge-tts --list-voices 输出为准。

为什么用 pipx 装命令行工具

pipx 是专门用来装和运行 Python 写的命令行工具的包管理器，思路类似于 macOS 的 Homebrew、Ubuntu 的 apt、Node 的 npx：给每个工具建独立的虚拟环境，互不污染你项目用的 Python 依赖。它依赖 pip 和 venv，需要 Python 3.6 及以上。

相比之下，直接 pip install 到系统 Python 容易把系统包依赖搞乱，而 pipx 装的 edge-tts 命令在终端里随处可用，最省事。

安装步骤

下面以 Ubuntu / Debian 系（含 WSL2）为例。

1. 装 pipx

sudo apt install pipx

安装后按提示把 pipx 的 bin 目录加到 PATH（一般提示里会给出 pipx ensurepath 这样的命令），重开一个终端窗口让配置生效。

2. 装 edge-tts

pipx install edge-tts

装完直接在终端敲 edge-tts --help 应该能看到参数说明，说明命令已进 PATH。

生成第一个 mp3

任选一个目录，执行：

edge-tts --text "edge-tts 支持英语、汉语、日语、韩语、法语等 40 多种语言" --write-media hello.mp3

几秒钟后当前目录出现 hello.mp3，拷到桌面用播放器打开就能听。注意命令里的引号不能省，中文文本含空格时必须用引号包起来。

常用参数

• --voice：指定音色，比如 --voice zh-CN-XiaoxiaoNeural；先看 edge-tts --list-voices 拿到全量列表和中文音色名。
• --rate：语速，如 --rate=+10%（加快）或 --rate=-15%。
• --pitch：音调，如 --pitch=+20Hz。
• --write-media：输出音频文件；--write-subtitles 可同时输出旁白（SRT）字幕文件。
• --stdout：把音频直接输出到标准流，适合管道给播放器实时播放。

例：换音色并放慢一点：edge-tts --voice zh-CN-YunxiNeural --rate=-10% --text "欢迎收看" --write-media t1.mp3

实时播放这件事

命令行一次性生成 mp3 只是最基础的用法。想做“边生成边播”的实时播报，需要走 Python 接口：用 edge-tts.Communicate 订阅音频流，把 stream() 吐出的块写进音频管道（如 mpg123、ffplay）而非落盘，就能做到接近实时的朗读。这个方向坑点在网络延迟与缓冲，需要先打通单条合成再调管道。

踩坑提醒

• 命令没引号：中文句子里有空格，不加引号 shell 会把后面的当参数，直接报错。
• 命令找不到：装完 pipx 没 ensurepath/重开终端，PATH 里没这条命令；也可以 pipx ensurepath 后重启 shell。
• 音色名写错：音色 ID 区分大小写且会调整，先跑 --list-voices 复制准确名字。
• 网络不通：WSL2 需要能访问微软服务，连不上会卡住或超时，先确认宿主机网络策略。
• 输出目录：默认写到当前工作目录，用绝对路径 --write-media /home/你的用户名/桌面/hello.mp3 更明确。

qidao123.com企服评测-应用市场 编辑提示

本文基于社区原帖《Edge-TTS：微软推出的，免费、开源、支持多种中文语音语色的AI工具[工具版]》重写，补全了命令中被吞掉的空格，把 install 安装步骤补成 pipx 安装 + PATH 配置 + 常用参数 + 实时播放思路，并说明了它依赖在线服务而非离线模型这一前提。音色名称与语言数量以项目官方维护的语音列表为准，本文不提供任何第三方或镜像版的下载地址。