ReFramework 是 UiPath 官方推荐的通用自动化框架(Robotic Enterprise Framework),用于构建稳定、可维护的 RPA 流程。然而,在中文环境下使用时,常遇到界面显示乱码、日志无法正常输出中文等问题。本文将手把手教你如何正确设置 ReFramework 的中文支持。
为什么需要设置中文?
- 确保异常信息、日志内容能正确显示中文
- 避免流程中处理中文文本时出现编码错误
- 提升团队协作效率,尤其在中文业务场景下
设置步骤
- 修改系统区域设置:在 Windows 系统中,进入“控制面板 > 区域 > 管理”,将“非 Unicode 程序的语言”设为“中文(简体,中国)”,并重启电脑。
- 配置 UiPath Studio 编码:在 Studio 中打开 ReFramework 项目,确保所有 .xaml 文件保存为 UTF-8 编码(可通过外部编辑器如 VS Code 转换)。
- 调整日志编码:在 ReFramework 的“InitAllSettings.xaml”中,检查日志写入组件(如 Write Line 或 Log Message)是否支持 Unicode。建议使用“Log Message”活动,并确保 Orchestrator 或本地日志文件以 UTF-8 读取。
- 测试中文输出:在流程中加入测试步骤,例如使用“Write Line”输出“你好,ReFramework!”,验证控制台或日志是否正常显示。
常见问题
Q:设置了还是乱码?
A:请确认机器人运行账户的区域设置与开发环境一致,且日志查看工具(如记事本)以 UTF-8 打开日志文件。
Q:Orchestrator 日志不显示中文?
A:Orchestrator 默认支持 UTF-8,但需确保机器人机器人的系统 locale 正确,并避免使用旧版 .NET Framework 控制台应用输出日志。
结语
正确配置 ReFramework 的中文环境,不仅能提升开发体验,还能避免生产环境中因编码问题导致的流程失败。建议在项目初期就统一团队的系统与编码规范。