Flutter端UTF-8特殊字符显示异常，Web端正常求解决方案

1. 强制手动解码并处理UTF-8 BOM #

http包在移动端有时会自动按响应头编码解码，但如果API返回的UTF-8带有字节顺序标记（BOM），会导致解码异常。直接使用bodyBytes手动解码并移除BOM：

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<List<String>> fetchData() async {
  final response = await http.get(Uri.parse('你的API地址'));
  if (response.statusCode == 200) {
    List<int> bytes = response.bodyBytes;
    // 移除UTF-8 BOM（EF BB BF）
    if (bytes.length >= 3 && bytes[0] == 0xEF && bytes[1] == 0xBB && bytes[2] == 0xBF) {
      bytes = bytes.sublist(3);
    }
    final String rawString = utf8.decode(bytes);
    // 假设API返回的是JSON数组，解析成字符串列表
    return List<String>.from(json.decode(rawString));
  } else {
    throw Exception('请求失败');
  }
}

2. 更换支持特殊字符的字体 #

移动端默认字体（如Android的Roboto、iOS的San Francisco）可能不覆盖所有特殊字符（如生僻字、小众语言符号、特殊emoji），指定兼容字体即可解决：

• 使用系统内置兼容字体：

Text(
  item,
  style: TextStyle(
    // 中文可选PingFang SC（iOS）、Noto Sans SC（Android）
    fontFamily: 'Noto Sans SC',
  ),
)

• 使用第三方字体包（如google_fonts）：
  先在pubspec.yaml添加依赖：

dependencies:
  google_fonts: ^6.1.0

然后使用：

import 'package:google_fonts/google_fonts.dart';

Text(
  item,
  style: GoogleFonts.notoSans(), // Noto Sans支持绝大多数语言字符
)

3. 确认API实际编码并对应解码 #

如果API响应头标注的UTF-8不准确（实际为GBK、GB2312等编码），utf8.decode会导致乱码。可以用Postman查看响应原始字节，确认编码后用对应解码器：
比如针对GBK编码，使用charset_converter包：

dependencies:
  charset_converter: ^3.0.0

解码代码：

import 'package:charset_converter/charset_converter.dart';

final String decodedText = await CharsetConverter.decode("GBK", response.bodyBytes);

4. 处理HTML实体转义 #

如果API返回的字符串包含HTML实体（如&、©），Flutter的Text组件不会自动解析，而Web端浏览器会处理。这种情况用flutter_html组件替代：

dependencies:
  flutter_html: ^3.0.0

使用示例：

import 'package:flutter_html/flutter_html.dart';

Html(data: item);

内容的提问来源于stack exchange，提问作者exilonX