SetupFactory 7中文说明书常见问题：安装路径乱码如何解决？

Question

在使用SetupFactory 7制作中文安装包时，常有用户反馈“安装路径包含中文字符时出现乱码”问题。该问题多出现在Windows非Unicode系统或目标系统区域设置不兼容的情况下，导致安装程序无法正确解析含中文的自定义安装路径，进而引发文件释放失败或路径错乱。此为SetupFactory 7对多字节字符集（MBCS）支持不完善的典型表现，尤其在旧版运行库环境下更为明显。如何确保安装路径中的中文正确识别并避免乱码，是开发者部署中文软件时常遇到的关键技术难题。

Answer 1

一、问题背景与现象描述

在使用SetupFactory 7制作中文安装包时，用户频繁反馈“安装路径包含中文字符时出现乱码”的问题。该问题主要表现为：当用户选择如C:\软件安装\程序这类含中文的自定义路径时，安装程序在文件释放阶段报错或生成路径为C:\软件安装\\等乱码形式。

此现象多发于以下环境：

• Windows XP 或 Windows Server 2003 等非Unicode默认系统
• 系统区域设置为“英语（美国）”但需支持中文路径
• 目标机器未安装中文语言包或缺少多字节支持组件

二、技术成因分析

SetupFactory 7 基于 Lua 脚本引擎构建，其底层运行库对宽字符（Unicode）支持有限，尤其在处理 MBCS（多字节字符集）路径时依赖操作系统的代码页转换机制。以下是关键成因：

1. ANSI API调用限制：SetupFactory 内部多数路径操作使用Windows ANSI版本API（如CreateDirectoryA），在非中文系统中会错误解析UTF-8或GBK编码的路径字符串。
2. Lua字符串编码混淆：Lua脚本本身不区分编码，若路径变量从界面输入后未经正确转码即传入API，极易导致字节流错位。
3. 安装引擎运行时环境隔离：打包后的执行体运行在独立沙箱中，无法自动继承母体系统的LCID（Locale ID）设置。

系统环境	代码页 (ACP)	典型表现	是否易出乱码
简体中文 Windows 10	936 (GBK)	正常显示	否
英文版 Win7 + 区域设为中文	936	部分API失败	是
日文系统（CP932）	932 (Shift-JIS)	中文路径完全乱码	高
服务器无GUI + 英语locale	1252	路径被截断或拒绝创建	极高

三、解决方案层级演进

针对上述问题，可采取由浅至深的四级应对策略：

1. 用户层规避（初级）

通过UI提示强制用户避免使用中文路径：

-- 在InstallPathBrowse.lua 中添加验证逻辑
function OnClick()
    local path = Dialogs.InstallPathBrowse.Path;
    if string.find(path, "[\u4e00-\u9fa5]") then
        Dialogs.MessageBox("安装路径不能包含中文字符，请使用英文字母路径！", "警告", MB_OK + MB_ICONWARNING);
        return false;
    end
    return true;
end

2. 编码预处理（中级）

利用SetupFactory提供的Encoding.Convert()函数进行路径转码：

function ConvertToOEM(path)
    if not path then return "" end
    -- 将UTF-8路径转换为当前系统OEM代码页
    return Encoding.Convert(path, ENCODING_UTF8, ENCODING_OEM);
end

-- 应用于文件释放前
Project.SetVariable("INSTALL_PATH", ConvertToOEM(UI.InstallFolder));

3. 外部DLL注入（高级）

编写C++动态链接库，暴露Unicode兼容接口供Lua调用：

• 导出函数：CreateDirectoryWWrapper(wchar_t* path)
• 使用__stdcall调用约定确保兼容性
• 在SetupFactory中通过DLL.Call调用

4. 构建环境升级（根本性解决）

迁移至SetupFactory 9+ 或改用Inno Setup / Advanced Installer等原生支持Unicode的工具链。若必须使用SF7，则应在以下方面优化：

• 编译时嵌入Microsoft.VC90.CRT运行库以增强字符处理能力
• 启用“Use Unicode APIs where possible”隐含选项（需修改project.sfb内部XML）
• 部署前在多语言虚拟机中做路径兼容性测试

四、诊断流程图

graph TD
            A[用户反馈安装路径乱码] --> B{操作系统是否为中文 locale?}
            B -- 是 --> C[检查安装包是否启用MBCS支持]
            B -- 否 --> D[确认是否安装中文语言包]
            C --> E{路径是否通过Lua脚本拼接?}
            D --> F[尝试切换系统区域为中文(非Unicode)]
            E -- 是 --> G[插入Encoding.Convert调试输出]
            G --> H[观察控制台日志编码变化]
            F --> I[重新运行安装程序]
            I --> J[成功?]
            H --> J
            J -- 否 --> K[使用Process Monitor抓取CreateFileW调用参数]
            K --> L[分析传入路径是否已损坏]

五、长期建议与最佳实践

对于仍在维护SetupFactory 7项目的团队，建议建立如下规范：

• 所有路径变量在获取后立即做Encoding.SafeEncode()封装
• 禁用“允许用户自定义安装路径”功能，在企业环境中统一部署标准路径如C:\App\
• 在安装日志中启用详细字符调试模式（需修改debug.ini）
• 对每个发布版本进行跨区域测试矩阵验证，涵盖至少5种不同LCID环境

此外，应逐步将核心安装项目迁移到支持WideChar的现代打包工具，从根本上规避MBCS遗留问题。