构建 Windows

本文档描述了 Windows 的构建过程。如果您遇到问题，请加入我们的 Discord #contributing 频道寻求帮助。

强烈建议使用 PowerShell 7 (pwsh.exe) 而不是默认的 powershell.exe。

先决条件

启用脚本

默认情况下，运行未经验证的脚本会被阻止。

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Unrestricted

系统依赖

Bun v1.1 或更高版本。我们使用 Bun 来运行其自身的代码生成器。

irm bun.sh/install.ps1 | iex

Visual Studio 以及“使用 C++ 的桌面开发”工作负载。安装时，请确保同时安装 Git，如果尚未安装 Git for Windows。

可以使用向导以图形方式安装 Visual Studio，也可以通过 WinGet 安装

winget install "Visual Studio Community 2022" --override "--add Microsoft.VisualStudio.Workload.NativeDesktop Microsoft.VisualStudio.Component.Git " -s msstore

安装 Visual Studio 后，您需要以下内容

LLVM 18.1.8
Go
Rust
NASM
Perl
Ruby
Node.js
Ccache

注意 – Zig 编译器由构建过程自动下载、安装和更新。

Scoop 可以轻松用于安装这些剩余工具。

Scoop

Scoop
irm https://get.scoop.sh | iex
scoop install nodejs-lts go rust nasm ruby perl ccache
# scoop seems to be buggy if you install llvm and the rest at the same time
scoop install llvm@18.1.8

请不要对这些使用 WinGet/其他包管理器，因为您很可能安装 Strawberry Perl 而不是更精简的 Perl 安装。Strawberry Perl 包含许多其他实用程序，这些实用程序会安装到 $Env:PATH 中，这将与 MSVC 冲突并破坏构建。

如果您打算在本地构建 WebKit（可选），则应安装以下软件包

Scoop
scoop install make cygwin python

从现在开始，期望您使用已加载 .\scripts\vs-shell.ps1 的 PowerShell 终端。此脚本在 Bun 存储库中可用，可以通过执行它来加载

.\scripts\vs-shell.ps1

要验证，您可以检查仅 MSVC 的命令行，例如 mt.exe

Get-Command mt

不建议将 ninja / cmake 安装到全局路径中，因为您可能会遇到在未加载 .\scripts\vs-shell.ps1 的情况下尝试构建 bun 的情况。

构建

bun run build

# after the initial `bun run build` you can use the following to build
ninja -Cbuild/debug

如果成功，您应该在 build/debug 文件夹中有一个 bun-debug.exe。

.\build\debug\bun-debug.exe --revision

你应该将此添加到 $Env:PATH。最简单的方法是打开开始菜单，输入 "Path"，然后导航到环境变量菜单，将 C:\.....\bun\build\debug 添加到用户环境变量 PATH 中。然后你应该重启你的编辑器（如果仍然没有更新，请注销并重新登录）。

额外路径

WebKit 被提取到 build/debug/cache/webkit/
Zig 被提取到 build/debug/cache/zig/bin/zig.exe

测试

你可以使用 bun test <path>，或者使用包装脚本 packages\bun-internal-test 来运行测试套件。内部测试包是一个包装 CLI，用于在 bun.exe 的单独实例中运行每个测试文件，以防止测试运行器中的崩溃停止整个套件。

# Setup
bun i --cwd packages\bun-internal-test

# Run the entire test suite with reporter
# the package.json script "test" uses "build/debug/bun-debug.exe" by default
bun run test

# Run an individual test file:
bun-debug test node\fs
bun-debug test "C:\bun\test\js\bun\resolve\import-meta.test.js"

先决条件

启用脚本

系统依赖

构建

额外路径

测试

故障排除

.rc 文件构建失败

无法写入输出 'bun-debug.exe'：权限被拒绝