Cherry Studio 在 WSL 中的安装说明

环境

• WSL2（Ubuntu Noble / 24.04）
• 使用 WSLg 显示图形界面（Windows 11）

1. 安装 deb 包

cd "/mnt/c/users/12828/desktop/新建文件夹"
sudo dpkg -i Cherry-Studio-1.7.19-amd64.deb

若出现依赖错误，执行：

sudo apt-get update
sudo apt-get install -f

仍有缺失依赖时可手动安装：

sudo apt-get install libnotify4 libnss3 libxss1 xdg-utils libsecret-1-0

然后再次执行：

sudo dpkg -i Cherry-Studio-1.7.19-amd64.deb

2. 声音库（解决 libasound.so.2）

Ubuntu 24 中包名为 libasound2t64：

sudo apt-get install libasound2t64

3. 启动方式

可执行文件位于 /opt/Cherry Studio/，未加入 PATH，需用完整路径：

/opt/Cherry\ Studio/CherryStudio

可选：创建软链接，之后可直接用 cherrystudio 命令：

sudo ln -sf "/opt/Cherry Studio/CherryStudio" /usr/local/bin/cherrystudio

然后：

cherrystudio

4. 中文显示修复（方框 □□□□）

安装中文字体：

sudo apt-get install fonts-noto-cjk

可选备用：

sudo apt-get install fonts-wqy-zenhei

安装后关闭并重新打开 Cherry Studio。

5. Emoji 显示修复

安装 emoji 字体并刷新字体缓存：

sudo apt-get install fonts-noto-color-emoji
fc-cache -fv

可选：

sudo apt-get install fonts-emojione
fc-cache -fv

安装后关闭并重新打开 Cherry Studio。

6. 一键安装依赖（可选）

若在新 WSL 或新系统上重装，可先执行以下命令再装 deb：

sudo apt-get update
sudo apt-get install -f libasound2t64 fonts-noto-cjk fonts-noto-color-emoji
fc-cache -fv

然后再执行本文第 1 步的 dpkg -i。

7. 注意事项

• WSLg：需 Windows 11，WSL 2，图形会直接显示在 Windows 桌面。
• Windows 10：需在 Windows 安装 X 服务器（如 VcXsrv），并在 WSL 中设置 export DISPLAY=... 后再运行 Cherry Studio。
• 每次修改字体或安装新字体后，建议重启 Cherry Studio 以生效。