Xamarin iOS出现Source file is not valid UTF-8报错如何解决
「Source file is not valid UTF-8」报错解决方案
1. 定位异常编码文件
- 先从编译报错日志中提取触发错误的具体文件路径,重点排查近期修改过的代码文件、配置文件,以及文件名/内容包含中文、全角符号等非ASCII字符的文件。
2. 单文件编码修正
VS 2019可直接修改目标文件编码,操作如下:
- 打开报错对应的源文件
- 点击顶部菜单栏
文件→高级保存选项 - 在编码下拉列表中选择 Unicode (UTF-8 带签名) - 代码页 65001
- 确认后保存文件即可
若文件菜单找不到「高级保存选项」,可通过
工具→自定义→命令→ 选择「文件」菜单栏 → 点击「添加命令」→ 类别选「文件」→ 找到「高级保存选项」添加到菜单列表即可。
3. 全局默认编码配置
为避免后续新建文件再出现同类问题,可配置VS全局默认编码:
- 安装VS 2019扩展
Force UTF-8 (with BOM),扩展生效后所有新创建的文件都会默认使用带BOM的UTF-8格式保存。 - 打开iOS项目对应的
.csproj文件,排查是否存在<CodePage>相关配置项,如有则直接删除该配置,避免强制指定其他编码。
4. 资源文件排查
如果报错指向的是资源类文件,按以下规则检查:
- 本地化字符串文件(如
*.resx)、脚本配置文件全部统一为带BOM的UTF-8编码 - 所有资源文件名、资源存放路径避免使用中文、全角符号、特殊emoji等字符,统一使用半角英文命名。
5. 缓存清理验证
所有修改完成后执行缓存清理操作:
- 点击VS顶部菜单栏
生成→清理解决方案 - 手动删除项目根目录下的
bin、obj文件夹 - 重新与Mac编译机配对后执行生成操作,验证报错是否消失。
内容的提问来源于stack exchange,提问作者user246392
相关产品推荐
相关产品推荐

