How to Fix Chinese Font Display Issues in ClashDotNet

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 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 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 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 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 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 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.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}