在嵌入式开发板配置 WiFi 连接时，wpa_supplicant.conf 是核心配置文件，但当 WiFi 名或密码包含空格、特殊符号或中文字符时，直接明文填写可能会导致配置失效。本文总结 WPA/WPA2、WPA3 两种加密模式下，特殊字符的正确配置方法。

目录

一、完整的 wpa_supplicant.conf 基础模板

二、不同加密模式下特殊字符的处理方法

1. WIFI名 SSID处理

2. WIFI密码 PSK处理，WPA/WPA2 模式（最常用）

3. WIFI密码 sae_password 处理，WPA3 模式（SAE 加密）

三、转换后wpa_supplicant.conf文件：

---

一、完整的 wpa_supplicant.conf 基础模板

ctrl_interface=/var/run/wpa_supplicant
ap_scan=1 

network={ 
    priority=1 
    scan_ssid=1 
    # WiFi名称
    ssid="清宁嵌入式"
    # WPA/WPA2模式WIFI密码
    psk="qingningqianrushi"""#'\\\"
    # WPA3模式WIFI密码
    sae_password="qingningqianrushi"""#'\\\"
    key_mgmt=SAE WPA-PSK WPA-PSK-SHA256 
    ieee80211w=1 
}

二、不同加密模式下特殊字符的处理方法

1. WIFI名 SSID处理

SSID需将特殊字符密码转为 16 进制字符串，再填入 SSID 字段。

比如 清宁嵌入式 的十六进制是

e6b885e5ae81e5b58ce585a5e5bc8f

将该 16 进制字符串填入 SSID 字段（无需加引号）

注意：字符串转16进制时，如果字符串中有特殊字符容易转错，注意特殊字符的转义问题。

2. WIFI密码 PSK处理，WPA/WPA2 模式（最常用）

当密码包含”#\$ 等特殊字符时，禁止直接明文填写，需通过 wpa_passphrase 工具生成加密后的 psk 值。

操作步骤：

注意使用wpa_passphrase时，WIFI名和密码建议使用单引号引起来，若WIFI名和密码中本身含有单引号，需将 '   转义为   '\''      

/$wpa_passphrase '清宁嵌入式' 'qingningqianrushi"""#'\''\\\'

命令输出结果（提取 psk= 后的字符串即可）

network={
	ssid="清宁嵌入式"
	#psk="qingningqianrushi"""#'\\\"
	psk=268cf94a76ebe969e40229a40d176e48f055ed9ce3fd6d7f521d46ec0e91e6a6
}

3. WIFI密码 sae_password 处理，WPA3 模式（SAE 加密）

WPA3 需将特殊字符密码转为 16 进制字符串，再填入 sae_password 字段。

操作方法同SSID。

三、转换后wpa_supplicant.conf文件：

ctrl_interface=/var/run/wpa_supplicant
ap_scan=1 

network={ 
    priority=1 
    scan_ssid=1 
    # WiFi名称
    # ssid="清宁嵌入式"
    ssid=e6b885e5ae81e5b58ce585a5e5bc8f
    # WPA/WPA2模式WIFI密码
    # psk="qingningqianrushi"""#'\\\"
    psk=268cf94a76ebe969e40229a40d176e48f055ed9ce3fd6d7f521d46ec0e91e6a6
    # WPA3模式WIFI密码
    # sae_password="qingningqianrushi"""#'\\\"
    sae_password=71696e676e696e677169616e727573686922222223275c5c5c
    key_mgmt=SAE WPA-PSK WPA-PSK-SHA256 
    ieee80211w=1 
}