IndexTTS-2 本地部署指南 - Shirley Auspice's Blog

更改 UV 安装位置（建议）#

UV 又是一个默认安装在 C 盘的小软件……这里建议通过PowerShell独立安装而不是通过pip安装，方便全局使用

官方给的安装命令是这样的：

1
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

略做修改：

1
powershell -ExecutionPolicy ByPass -c {$env:UV_INSTALL_DIR = "D:\uv";irm https://astral.sh/uv/install.ps1 | iex}

将D:\uv改为你实际需要安装的位置

类似输出：

1
PS C:\Users\Admin> powershell -ExecutionPolicy ByPass -c {$env:UV_INSTALL_DIR = "D:\uv";irm https://astral.sh/uv/install.ps1 | iex}
2
Downloading uv 0.10.4 (x86_64-pc-windows-msvc)
3
Installing to D:\uv
4
  uv.exe
5
  uvx.exe
6
  uvw.exe
7
everything's installed!
8

9
To add D:\uv to your PATH, either restart your shell or run:
10

11
    set Path=D:\uv;%Path%   (cmd)
12
    $env:Path = "D:\uv;$env:Path"   (powershell)

添加环境变量#

终端中输出的指令（如下）执行后只对当前会话有效，永久修改环境变量的命令有点长，还不如手动添加

1
To add D:\uv to your PATH, either restart your shell or run:
2

3
    set Path=D:\uv;%Path%   (cmd)
4
    $env:Path = "D:\uv;$env:Path"   (powershell)

将D:\uv添加到系统Path环境变量里，接下来是指定文件保存位置：

变量名	变量值
`UV_CACHE_DIR`	`D:\uv\cache`
`UV_TOOL_DIR`	`D:\uv\tools`
`UV_PYTHON_INSTALL_DIR`	`D:\uv\python`

重启终端，依次执行

1
uv --version

1
uv python dir

1
uv cache dir

1
uv tool dir

验证安装以及目录更改是否成功，输出示例：

1
PS C:\Users\Admin> uv --version
2
uv 0.10.4 (079e3fd05 2026-02-17)
3
PS C:\Users\Admin> uv python dir
4
D:\uv\python
5
PS C:\Users\Admin> uv cache dir
6
D:\uv\cache
7
PS C:\Users\Admin> uv tool dir
8
D:\uv\tools

安装 Git#

什么是 Git
Git 是一个免费且开源的分布式版本控制系统，旨在快速高效地处理从小型到非常大型的项目，官网：https://git-scm.com

什么是 Git LFS
GGit LFS（Git Large File Storage）是一个用于用 Git 管理大型文件的命令行扩展和规范，官网：https://git-lfs.com

NOTE
目前Git LFS已经集成在了Git for Windows中，直接下载和使用最新版本的 Windows Git 即可，当然，你如果想单独安装Git LFS也是可以的

git

git-lfs

对于 Windows ，直接去https://gitforwindows.org下载Git for Windows，注意，软件是从GitHub下载的，请确保您的网络环境可以稳定访问GitHub，Git for Windows的安装设置略微有点儿麻烦，由于我已事先安装过了，为了写这个教程，我把Git卸载重装了🤣（安装的Git版本是2.53.0，不同版本的安装界可能有所不同）

TIP
以下内容使用 AI 辅助翻译，内容仅供参考，不保证翻译的准确性

01 许可文本#

直接点击 Next

02 选择安装位置，根据实际情况修改或不修改#

03 请选择要安装的组件#

（根据实际情况选择，我是全选的）

附加图标
- 在桌面上
Windows 文件资源管理器集成
- 在此处打开 Git Bash
- 在此处打开 Git GUI
Git LFS（大文件支持）
将 .git* 配置文件与默认文本编辑器关联
将 .sh 文件关联到 Bash 运行
每日检查 Git for Windows 更新
将 Git Bash 配置文件添加到 Windows 终端
Scalar（用于管理大规模仓库的 Git 插件）

04 开始菜单的快捷方式文件夹#

保持默认即可

05 选择 Git 使用的默认编辑器#

由于我使用Visual Studio Code，所以我选择这个，你可以根据实际情况选择

06 调整新仓库中初始分支的名称#

（建议保持默认）

您希望 Git 在执行“git init”后将初始分支命名为什么？

○ 让 Git 决定

让 Git 对新创建的仓库使用其默认分支名称（当前为：“master”）作为初始分支。

○ 覆盖新仓库的默认分支名称 许多团队已经重命名了他们的默认分支；常见的选择是“main”、“trunk”和“development”。指定“git init”应使用的初始分支名称：

main

此设置不影响现有仓库。

07 调整 PATH 环境#

（选择推荐项）

您希望如何从命令行使用 Git？

○ 仅从 Git Bash 使用 Git

这是最谨慎的选择，因为您的 PATH 将完全不会被修改。您将只能从 Git Bash 中使用 Git 命令行工具。

○ 从命令行以及第三方软件中使用 Git

（推荐）此选项仅将一些最小的 Git 包装器添加到您的 PATH 中，以避免使用可选的 Unix 工具污染您的环境。您将能够从 Git Bash、命令提示符和 Windows PowerShell 以及任何在 PATH 中寻找 Git 的第三方软件中使用 Git。

○ 从命令提示符中使用 Git 和可选的 Unix 工具

Git 和可选的 Unix 工具都将被添加到您的 PATH 中。

警告：这将覆盖 Windows 工具，例如“find”和“sort”。仅在您了解其影响的情况下使用此选项。

08 选择 SSH 可执行文件#

（建议保持默认）

您希望 Git 使用哪个 Secure Shell 客户端程序？

○ 使用捆绑的 OpenSSH

这将使用 Git 自带的 ssh.exe。

○ 使用外部的 OpenSSH

这将使用外部的 ssh.exe。Git 不会安装自己的 OpenSSH（及相关）二进制文件，而是使用在 PATH 中找到的它们。

09 选择 HTTPS 传输后端#

（建议保持默认）

您希望 Git 使用哪个 SSL/TLS 库进行 HTTPS 连接？

○ 使用 OpenSSL 库

服务器证书将使用 ca-bundle.crt 文件进行验证。

○ 使用本机 Windows Secure Channel 库

服务器证书将使用 Windows 证书存储进行验证。此选项还允许您使用公司内部根 CA 证书，例如通过 Active Directory 域服务分发的证书。

10 配置行尾转换#

（建议保持默认）

Git 应如何处理文本文件中的行尾？

○ 按 Windows 风格检出，提交 Unix 风格的行尾

Git 在检出文本文件时会将 LF 转换为 CRLF。在提交文本文件时，CRLF 会被转换为 LF。对于跨平台项目，这是在 Windows 上的推荐设置（“core.autocrlf”设置为“true”）。

○ 按原样检出，提交 Unix 风格的行尾

Git 在检出文本文件时不执行任何转换。在提交文本文件时，CRLF 会被转换为 LF。对于跨平台项目，这是在 Unix 上的推荐设置（“core.autocrlf”设置为“input”）。

○ 按原样检出，按原样提交

Git 在检出或提交文本文件时不执行任何转换。对于跨平台项目，不建议选择此选项（“core.autocrlf”设置为“false”）。

11 配置与 Git Bash 一起使用的终端模拟器#

（建议保持默认）

您想将哪个终端模拟器与 Git Bash 一起使用？

○ 使用 MinTTY（MSYS2 的默认终端） Git Bash 将使用 MinTTY 作为终端模拟器，它具有可调整大小的窗口、非矩形选择和 Unicode 字体。Windows 控制台程序（如交互式 Python）必须通过 winpty 启动才能在 MinTTY 中工作。

○ 使用 Windows 的默认控制台窗口

Git 将使用 Windows 的默认控制台窗口（“cmd.exe”），它能很好地与 Win32 控制台程序（如交互式 Python 或 node.js）配合使用，但默认回滚非常有限，需要配置为使用 Unicode 字体才能正确显示非 ASCII 字符，并且在 Windows 10 之前，其窗口无法自由调整大小，且仅允许矩形文本选择。

12 选择 git pull 的默认行为#

（建议保持默认）

默认情况下 git pull 应该做什么？

○ 快进或合并

尽可能快进当前分支到获取的分支，否则创建一个合并提交。

○ 变基

将当前分支变基到获取的分支。如果没有要变基的本地提交，这等同于快进。

○ 仅快进

快进到获取的分支。如果不可能则失败。这是 git pull 的标准行为。

13 选择凭据助手#

（建议保持默认）

应配置哪个凭据助手？

○ Git Credential Manager

使用跨平台的 Git Credential Manager。在此处查看有关 Git Credential Manager 未来的更多信息。

○ 无

不使用凭据助手。

14 配置额外选项#

（建议保持默认）

您希望启用哪些功能？

○ 启用文件系统缓存

对于某些操作，文件系统数据将被批量读取并缓存在内存中（“core.fscache”设置为“true”）。这提供了显著的性能提升。

○ 启用符号链接

启用符号链接（需要 SeCreateSymbolicLink 权限）。请注意，现有仓库不受此设置影响。

点击Install等待完成即可

（呼~好累啊……

部署 IndexTTS-2#

IndexTTS-2 是什么
IndexTTS-2 是哔哩哔哩发布的一款支持情感表达与时长可控的自回归零样本开源语音合成模型，能够在零样本条件下精准复刻音色，并独立控制情感，实现高自然度与高同步性的语音生成。

index-tts