超详细BetterDiscord安装指南：从0到1打造个性化Discord客户端

2026-02-05 05:49:46作者：董斯意

你是否厌倦了Discord默认界面的单调乏味？是否想让聊天体验更加高效和个性化？BetterDiscord（简称BD）正是为解决这些痛点而生的强大工具。通过本指南，你将从零基础完成BetterDiscord的安装与基础配置，解锁自定义主题、插件扩展等实用功能，让Discord客户端焕然一新。

关于BetterDiscord

BetterDiscord是一款针对Discord桌面客户端的增强工具，它通过注入自定义代码扩展了Discord的原生功能。核心特性包括：

主题系统：支持CSS自定义界面样式，打造专属视觉体验
插件生态：提供丰富API接口，可安装各类功能插件
扩展管理：内置插件/主题商店，一键安装管理资源
开发工具：集成React DevTools等开发组件，便于自定义开发

项目核心实现位于src/betterdiscord/index.ts，通过Electron的渲染进程注入技术实现功能扩展。

系统兼容性检查

在开始安装前，请确认你的系统符合以下要求：

操作系统	最低版本要求	支持架构
Windows	Windows 7+	32/64位
macOS	macOS 10.10+	Intel/Apple Silicon
Linux	Ubuntu 14.04+	64位

注意：BetterDiscord仅支持标准本地安装的Discord客户端，不支持网页版、Snap包或便携版。系统兼容性检查逻辑可参考src/electron/main/modules/betterdiscord.ts中的平台判断代码。

安装准备

1. 安装Discord桌面客户端

如果尚未安装Discord，请先从官方渠道下载并安装最新版客户端：

Windows：从Microsoft Store或Discord官网下载
macOS：从App Store或Discord官网下载
Linux：通过包管理器安装或下载官方deb/rpm包

2. 下载BetterDiscord安装程序

BetterDiscord提供了针对不同系统的安装程序：

上述链接为项目镜像地址，确保国内网络可正常访问。

图形化安装步骤

Windows系统安装

双击运行下载的BetterDiscord-Windows.exe安装程序
在欢迎界面点击"Install BetterDiscord"
选择已安装的Discord版本（通常自动检测）
点击"Install"开始安装，等待进度完成
安装成功后，程序会自动重启Discord

安装程序会将核心文件部署到Discord的资源目录，并修改Electron的启动参数。关键安装逻辑位于scripts/inject.ts。

macOS系统安装

解压下载的BetterDiscord-Mac.zip压缩包
打开终端，执行以下命令授权并运行安装脚本：
```
chmod +x BetterDiscord-Mac
./BetterDiscord-Mac
```
按照终端提示完成安装流程
安装完成后手动重启Discord

macOS版本需要特别处理应用签名问题，具体实现可见src/electron/main/index.ts中的代码签名检查逻辑。

Linux系统安装

赋予AppImage文件执行权限：
```
chmod +x BetterDiscord-Linux.AppImage
```
运行安装程序：
```
./BetterDiscord-Linux.AppImage
```
按照图形界面指引完成安装

Linux版本需要注意Discord的安装路径，默认支持/opt/discord/和用户目录下的安装实例。

手动安装方法（高级用户）

当自动安装程序无法正常工作时，可以选择手动安装。适用于开发调试或特殊系统环境。

核心步骤

克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/be/BetterDiscord.git
cd BetterDiscord

安装依赖并构建项目：
```
npm install
npm run build
```
手动注入BetterDiscord：
```
node scripts/inject.ts
```

手动安装的核心逻辑位于scripts/inject.ts，通过修改Discord的app.asar文件实现代码注入。

目录结构说明

手动安装后，BetterDiscord会在用户目录下创建以下关键目录：

BetterDiscord/
├── data/              # 配置数据存储
│   ├── stable/        # 稳定版配置
│   ├── canary/        # 测试版配置
│   └── ptb/           # 预览版配置
├── plugins/           # 插件存储目录
└── themes/            # 主题存储目录

目录创建逻辑可参考src/electron/main/modules/betterdiscord.ts中的ensureDirectories方法。

验证安装

安装完成后，启动Discord客户端，验证BetterDiscord是否成功加载：

打开Discord设置（用户设置）
检查左侧菜单底部是否出现"BetterDiscord"选项
点击进入BetterDiscord设置页面，确认功能正常

如果安装失败，可以查看日志文件排查问题：

Windows: %appdata%\BetterDiscord\logs\
macOS: ~/Library/Application Support/BetterDiscord/logs/
Linux: ~/.config/BetterDiscord/logs/

日志系统实现位于src/betterdiscord/utils/debug.ts。

基本配置指南

访问BetterDiscord设置

成功安装后，通过以下步骤访问BetterDiscord设置面板：

点击Discord窗口左下角的用户设置图标（齿轮图标）
在左侧菜单底部找到"BetterDiscord"分类
点击展开子菜单，可访问各类设置项

设置面板的UI组件位于src/betterdiscord/ui/settings/目录下。

安装主题

访问BetterDiscord主题商店（在设置面板中）
浏览主题列表，点击"Install"安装喜欢的主题
在"已安装主题"列表中启用主题
可通过"自定义CSS"选项微调主题样式

主题系统的核心实现位于src/betterdiscord/modules/thememanager.ts，支持CSS变量和动态样式调整。

安装插件

进入BetterDiscord设置中的"插件"标签页
浏览插件商店或手动下载插件文件（.plugin.js）
将插件文件放入插件目录：
- Windows: %appdata%\BetterDiscord\plugins\
- macOS: ~/Library/Application Support/BetterDiscord/plugins/
- Linux: ~/.config/BetterDiscord/plugins/
在插件设置页面启用插件

插件加载逻辑位于src/betterdiscord/modules/pluginmanager.ts，支持热重载和错误隔离。