From 13f335befa76a1ecce6ff81e081190fb659737bc Mon Sep 17 00:00:00 2001 From: Richard Smith Date: Mon, 27 Jul 2026 10:45:02 -0700 Subject: [PATCH] Add instructions for Carbon development on Windows. (#7565) In passing, switch `uv` instructions from curl pipe to installation with `cargo`, and add missing libunwind dependency. --- docs/project/contribution_tools.md | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/docs/project/contribution_tools.md b/docs/project/contribution_tools.md index 127a5a2e7067..a79fa57333a9 100644 --- a/docs/project/contribution_tools.md +++ b/docs/project/contribution_tools.md @@ -18,6 +18,7 @@ contributions. - [Installing Bazelisk](#installing-bazelisk) - [Old `clang` versions](#old-clang-versions) - [macOS](#macos) + - [Windows](#windows) - [Tools](#tools) - [Main tools](#main-tools) - [Running prek](#running-prek) @@ -58,14 +59,12 @@ sudo apt install \ gh \ libc++-dev \ libc++abi-dev \ + libunwind-dev \ lld \ lldb -# Install `uv` for Python scripts. -curl -LsSf https://astral.sh/uv/install.sh | sh - -# Install `prek` for Git hooks. -cargo install --locked prek +# Install `uv` for Python scripts and `prek` for Git hooks. +cargo install --locked uv prek # Set up git. # If you don't already have a fork: @@ -150,6 +149,15 @@ bazel test //...:all +### Windows + +The easiest way to build Carbon on Windows is using WSL. Use `wsl --install` to +install Ubuntu, and then follow the [Debian or Ubuntu](#debian-or-ubuntu) setup +instructions. + +See [the VS Code documentation](https://code.visualstudio.com/docs/remote/wsl) +for instructions on how to configure VS Code to work with WSL. + ## Tools ### Main tools