必须先执行 uname -m 确认架构：输出 aarch64 为ARM64平台，需用Box64+Wine64组合；输出 x86_64 为x86平台，可走WineHQ官方源安装；架构误判将导致90%后续失败。
在麒麟OS上运行Windows程序必须先搭建Wine运行环境，否则双击.exe文件会提示“命令未找到”“无法执行二进制文件”或直接退出；跳过架构确认与多架构启用步骤，90%的后续失败都源于此。
确认系统架构与版本基线
第一步：打开终端，执行 uname -m 查看CPU类型。若输出 【aarch64】，说明是飞腾、鲲鹏等ARM64设备，必须用Box64+Wine64组合；若输出 【x86_64】，可走标准WineHQ官方源安装路径。
第二步：执行 cat /etc/os-release | grep VERSION_CODENAME，确认输出是否为 focal——这是银河麒麟V10 SP1/SP2的通用基线，决定后续仓库地址和依赖包名。
第三步：对ARM64平台，立即执行 sudo dpkg --add-architecture armhf && sudo apt update。这一步漏掉，后续安装任何armhf库都会报“no such file or directory”。
安装Wine主程序
方法一（x86_64平台推荐）：使用WineHQ稳定版
执行以下命令一次性完成密钥导入、仓库添加与安装：sudo apt install -y software-properties-common && wget -O- https://dl.winehq.org/wine-builds/winehq.key | sudo apt-key add - && echo "deb https://dl.winehq.org/wine-builds/ubuntu/ focal main" | sudo tee /etc/apt/sources.list.d/winehq.list && sudo apt update && sudo apt install --install-recommends -y winehq-stable
方法二（ARM64平台必需）：Box64 + Wine64协同方案
先添加Box64源：sudo wget https://ryanfortner.github.io/box64-debs/box64.list -O /etc/apt/sources.list.d/box64.list → 更新并安装：sudo apt update && sudo apt install -y box64 wine64 → 【必须建立统一入口】：sudo ln -sf /usr/bin/wine64 /usr/local/bin/wine，否则所有 wine xxx.exe 命令都会失败。
方法三（通用快速验证）：系统源一键部署sudo apt update && sudo apt install -y wine。注意：该方式安装的Wine通常为8.x版本，不支持DirectX 12或.NET 6+程序，运行大型工具时大概率闪退。
启用多架构支持
① 若为ARM64平台（uname -m 返回 aarch64），执行：sudo dpkg --add-architecture armhf && sudo apt update。
② 安装核心armhf基础库：sudo apt install -y libc6:armhf libglib2.0-0:armhf libx11-6:armhf libxext6:armhf libasound2:armhf。
③ 若为x86_64平台，改用i386架构支持：sudo dpkg --add-architecture i386 && sudo apt update && sudo apt install -y libc6:i386 libglib2.0-0:i386 libx11-6:i386 libxext6:i386 libasound2:i386。
配置Wine运行环境
初次运行Wine需初始化用户容器目录（~/.wine）并设定Windows模拟版本，该步骤决定API行为兼容性，直接影响程序启动成功率。
执行 winecfg 启动图形化配置工具。
在“驱动器”选项卡中，确认C盘映射路径为 /home/用户名/.wine/drive_c。
切换至“函数库”选项卡，在“新增函数库顶替”栏输入 winemenubuilder.exe，下拉选择禁用——防止桌面图标异常生成或重复创建。
在“设置”选项卡中，将Windows版本设为Windows 10，点击“确定”保存。
安装Windows运行库
多数.exe程序依赖Microsoft Visual C++、.NET Framework或DirectX组件；原生Wine不内置这些DLL，缺失将导致黑屏、闪退或报错“找不到指定模块”。
安装winetricks工具：sudo apt install winetricks。
设置环境变量以启用32位模式（对x86程序至关重要）：export WINEARCH=win32。
运行以下命令安装核心运行库：winetricks -q vcrun2019 dotnet48 corefonts。其中vcrun2019是当前绝大多数安装类程序的最低运行依赖，缺省会导致setup.exe直接退出。
