# How to Fix Chinese Font Display Issues in ClashDotNet

> Resolve ClashDotNet Chinese font display problems by installing a CJK font package on Windows. Restart the client to ensure correct glyph loading for an improved user experience.

- Repository: [如何翻墙/fanqiang](https://github.com/bannedbook/fanqiang)
- Tags: how-to-guide
- Published: 2026-09-05

---

**To fix Chinese font display issues in ClashDotNet, install a CJK font package (such as SimSun, Microsoft YaHei, or Noto Sans CJK) on your Windows system, then restart the client so the .NET 5 UI components can load the proper glyphs.**

ClashDotNet, the .NET 5-based GUI for Clash, renders Chinese characters using system fonts rather than bundled resources. When Windows lacks the necessary CJK font files—common on fresh English-only installations—the interface displays garbled or "weird" text in settings panels, node lists, and logs, as documented in the [`windows/ClashDotNetFramework.md`](https://github.com/bannedbook/fanqiang/blob/main/windows/ClashDotNetFramework.md) guide within the bannedbook/fanqiang repository.

## Why Chinese Characters Appear Garbled in ClashDotNet

The root cause stems from how ClashDotNet handles text rendering:

- **Windows lacks CJK fonts** – Fresh Windows installations, particularly English-only editions, do not include SimSun, Microsoft YaHei, or other Chinese fonts required by .NET controls.

- **System font dependency** – According to the source guide at [`windows/ClashDotNetFramework.md`](https://github.com/bannedbook/fanqiang/blob/main/windows/ClashDotNetFramework.md) lines 44-53, ClashDotNet does not bundle its own font resources; it relies entirely on the operating system to supply glyphs.

- **ASCII fallback** – When .NET 5 UI components cannot locate required Chinese glyphs, they fall back to a default ASCII-only font, resulting in distorted or placeholder characters throughout the interface.

## Step-by-Step Solution to Fix Chinese Font Display Issues

Follow these steps from the repository documentation to resolve the display problems.

### Download the Required Font Package

Visit the official download page referenced in [`windows/ClashDotNetFramework.md`](https://github.com/bannedbook/fanqiang/blob/main/windows/ClashDotNetFramework.md) and obtain a zip archive containing Chinese font files. The guide points to resources including SimSun, Microsoft YaHei, or the open-source Noto Sans CJK fonts suitable for Windows systems.

### Install Fonts via Windows GUI

Extract the archive to a temporary folder, then install the fonts:

1. Navigate to the extracted `.ttf` files.
2. Right-click each font file.
3. Select **Install for all users** to ensure system-wide availability.

### Automate Installation with PowerShell

For batch installation without manual GUI interaction, use this PowerShell script adapted from the repository's technical documentation:

```powershell

# PowerShell script to install all .ttf fonts from a folder for all users

$fontFolder = "C:\Temp\ChineseFonts"
Get-ChildItem "$fontFolder\*.ttf" | ForEach-Object {
    $src  = $_.FullName
    $dest = "$env:SystemRoot\Fonts\" + $_.Name
    Copy-Item $src $dest -Force
    $regPath = "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts"
    Set-ItemProperty $regPath -Name $_.BaseName -Value $_.Name
}
Write-Host "Chinese fonts installed – please restart Clash Dot Net."

```

This script copies font files to the Windows Fonts directory and registers them in the system registry under `HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts`.

### Restart and Verify the Fix

After installing the fonts:

1. Close ClashDotNet completely.
2. Restart the application to force the .NET 5 UI to reload font information.
3. Navigate to **Settings → Display → Language** to confirm Chinese text renders correctly.

The repository guide at lines 48-53 of [`windows/ClashDotNetFramework.md`](https://github.com/bannedbook/fanqiang/blob/main/windows/ClashDotNetFramework.md) includes screenshots showing the before/after state for visual verification.

## Troubleshooting Persistent Display Problems

If Chinese characters remain garbled after font installation, verify your runtime environment. The guide notes at lines 33-36 that ClashDotNet requires the **.NET 5 runtime** to function correctly. Ensure the runtime is fully installed, as missing dependencies can interfere with text rendering even when proper fonts are present.

## Summary

- **ClashDotNet** relies on system fonts and does not bundle CJK resources, causing garbled text on Windows systems lacking Chinese fonts.
- Install **SimSun**, **Microsoft YaHei**, or **Noto Sans CJK** fonts system-wide to provide the required glyphs.
- Use the provided **PowerShell script** for automated batch installation across multiple machines.
- Always **restart the client** after font installation to reload the UI components.
- Verify **.NET 5 runtime** installation if display issues persist after adding fonts.

## Frequently Asked Questions

### Why does ClashDotNet show garbled text instead of Chinese characters?

ClashDotNet uses .NET 5 UI components that rely on Windows system fonts to render text. When the operating system lacks CJK (Chinese, Japanese, Korean) font files, the application falls back to an ASCII-only default font, displaying garbled or placeholder symbols in place of Chinese characters.

### Which specific font files does ClashDotNet require?

The application requires standard Chinese system fonts such as **SimSun** (宋体), **Microsoft YaHei** (微软雅黑), or alternatives like **Noto Sans CJK**. These fonts provide the Unicode glyphs necessary for the .NET 5 controls to render Chinese text correctly in the settings and node list interfaces.

### Can I fix the font issue without administrator privileges?

No. Installing fonts in Windows requires copying files to `C:\Windows\Fonts` and modifying the `HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts` registry key, both of which need administrative access. The PowerShell script provided in the repository documentation must run with elevated privileges to complete successfully.

### What if Chinese characters still appear broken after installing fonts?

Ensure the **.NET 5 runtime** is fully installed on your system. According to [`windows/ClashDotNetFramework.md`](https://github.com/bannedbook/fanqiang/blob/main/windows/ClashDotNetFramework.md) lines 33-36, missing runtime dependencies can prevent proper text rendering even when fonts are present. Download and install the latest .NET 5 runtime from Microsoft's official site, then restart ClashDotNet.