WiX项目文件（.wxs）是声明式XML配置，以Wix为根、Product为起点，需正确嵌套Component/File/Feature，通过RegistryKey、Shortcut等元素定义资源，并经candle+light编译为MSI。
WiX 项目文件（.wxs）是用 XML 编写的安装包定义，核心是描述要安装的文件、注册表项、快捷方式、服务等资源，以及安装逻辑（如条件、UI、自定义操作）。它不是“写代码”而是“声明式配置”，重点在于结构清晰、元素嵌套正确、引用关系准确。
基础结构：从一个最简 .wxs 开始
每个 .wxs 文件必须以 Wix 根元素开头，内含一个 Product 元素。Product 定义安装包整体属性（如 ID、升级码、语言、版本），是整个安装逻辑的起点。
- Product 的 Id 必须是 *（星号），表示每次生成新 GUID；UpgradeCode 必须固定，用于识别同一产品的不同版本升级
- Package 元素需指定 InstallerVersion（建议 ≥200）、Platform（x64 或 x86）、Languages（如 1033 表示英文）
- Directory 元素定义安装路径树，通常以 TARGETDIR（虚拟根目录）为起点，下挂 ProgramFilesFolder 等标准文件夹
添加文件：File 和 Component 是关键单元
你要安装的每个文件，必须包裹在 Component 元素中，而 Component 必须属于某个 Feature（功能模块），并放在 Directory 下。WiX 不允许文件“裸奔”——没有 Component 的 File 会被忽略。
- 每个 Component 应有唯一 Id（推荐用 GUID 或有意义的字符串），且最好只包含一个主文件（便于修复/卸载）
- 使用 ComponentGroup 可批量组织多个 Component，再通过 Feature 的 ComponentGroupRef 引用，提升可维护性
- 若文件来自本地路径，用 Source="path\to\file.exe"；若用 Heat 工具自动生成，会自动填充 SourceFile 属性
常用功能怎么加：注册表、快捷方式、启动项
这些不是靠“写命令”实现，而是用对应 WiX 元素声明：
- 注册表项：用 RegistryKey + RegistryValue，指定 Root（如 "HKLM"）、Key、Name、Value、Type（如 "string"）
- 桌面或开始菜单快捷方式：在 Component 内加 Shortcut 元素，Target 指向已安装的文件（用 File/@Id 引用），WorkingDirectory 可选
- 开机启动程序：Shortcut 可配合 CreateDesktopIcon 或 Advertise="yes" 控制是否创建；真正自启需配合 RegistryValue 写入 Run 键，或用 ServiceInstall 安装 Windows 服务
编译与调试：看清 wixobj 和 msi 的生成链
WiX 编译分两步：candle.exe 把 .wxs 编译成中间文件（.wixobj），light.exe 链接 .wixobj 和二进制资源生成最终 .msi。
- 常见报错如 “The Component element contains an unexpected child element 'File'” —— 说明 File 没包在 Component 里
- “Unresolved reference to symbol” 多因 Feature 没引用 Component，或 Component Id 拼写不一致
- 用 Orca（Windows SDK 工具）打开生成的 .msi，检查 _Tables、File、Component 表内容，是最直接的验证方式
基本上就这些。WiX 不复杂但容易忽略嵌套规则和引用一致性。先跑通一个带图标、注册表、快捷方式的 Hello World 安装包，后面扩展就顺了。
