Install Windows

Windows 安装

当前安装流程用于开发验证，已知使用问题和验证范围见开发状态及验证范围。

目标是安装工具，并按需构建一个已准备好的项目。先确认开发机符合支持平台。需要联网下载 setup 和安装包；目标项目需先完成 Composer 依赖安装。

下载与启动

从下载与发布记录的资产列表找名称以 -windows-x86_64-setup.cmd 结尾的 setup。不要下载 macOS 包或 components 包代替入口。将它放到单独目录，该目录只保留这一个 setup CMD。

在 Windows x64 的 PowerShell进入该目录，用实际下载的文件名启动；以下匹配不需要手动改版本号：

$setup = Get-ChildItem -File .\webman-aot-builder-*-windows-x86_64-setup.cmd
if (@($setup).Count -ne 1) { throw '此目录必须只有一个 Windows setup CMD，请检查下载文件。' }
& $setup.FullName

CMD 可输入下载文件的完整名称启动；不要把 macOS 的 sh 命令用于 Windows CMD。

已有工具源码时，使用源码制作安装包入口。

按提示完成

1. 选 1 轻量包 或 2 完整包；0 取消会结束。轻量包首次构建需联网准备组件；完整包包含组件，安装时可离线准备，但首次取得完整包仍需下载。
2. 等待下载、大小及 SHA-256 校验、归档检查。看到“包检查成功，进入安装确认与项目下一步”后继续。
3. 检查入口显示的安装目标、启动命令位置和 PATH 影响，再确认安装。看到“安装成功，当前入口可以直接构建项目”即完成安装。
4. 选 1 构建项目，输入包含 composer.json、composer.lock、start.php、app/ 的后端根目录；0 结束则保留已安装工具。项目构建失败可重试此目录、重选目录或结束。

成功结果与下一步

“项目构建与校验成功”和显示的 dist-aot/ 路径只表示入口报告的本机流程完成，不能替代自己的项目验收。整个目录是部署产物；接着按部署到 Linux检查配置、启动和业务接口。

重新打开终端，运行 webman-aot version 核对实际安装的工具标识；应与所选包相符，但版本输出不证明项目能正常构建或运行。以后从项目根目录按构建 Webman或构建 SaiAdmin执行。默认安装位置与卸载见升级与卸载。

失败时保留入口显示的阶段、原因和本机日志路径，按常见问题处理；日志不会自动上传。