Setup do linker (lld‐link) no Windows

Configurando o linker rápido (lld-link) no Windows

O projeto usa uma configuração em .cargo/config.toml que troca o linker padrão do Windows por um mais rápido:

[target.x86_64-pc-windows-msvc]
linker = "lld-link.exe"

Isso reduz bastante o tempo de compilação, mas o lld-link.exe não vem instalado por padrão — precisa ser configurado uma vez em cada máquina Windows. Este guia mostra como fazer isso.

Pré-requisitos

Antes de instalar o linker, confirme que você já tem:

1. Rust instalado — via [rustup.rs](https://rustup.rs)

2. Build Tools for Visual Studio com o workload "Desktop development with C++" marcado

   ⚠️ Atenção: o Visual Studio Code (o editor) e o Visual Studio Build Tools (as ferramentas de compilação C++) são produtos diferentes, apesar do nome parecido. Ter o VS Code instalado não é suficiente — se você rodar cargo run e aparecer o erro linker 'link.exe' not found, é sinal de que o workload de C++ não está instalado. Confirme abrindo o Visual Studio Installer e verificando se "Desktop development with C++" está marcado.

Passo a passo — instalando o lld-link

1. Instalar o LLVM (que inclui o lld-link.exe)

Abre um terminal (PowerShell ou cmd) e roda:

winget install LLVM.LLVM

Isso baixa e instala o LLVM automaticamente. Pode levar alguns minutos.

2. Reiniciar o terminal

Fecha todas as janelas de terminal abertas (inclusive dentro do VSCode) e abre uma nova. O PATH só é atualizado em janelas novas.

3. Confirmar que funcionou

lld-link --version

Se aparecer algo como LLD 22.x.x (...), está tudo certo e pode pular direto pro passo de rodar o projeto.

Se o comando não for reconhecido

Às vezes o instalador não adiciona o LLVM ao PATH automaticamente. Nesse caso, adiciona manualmente:

1. Confirma que o arquivo existe:

   dir "C:\Program Files\LLVM\bin\lld-link.exe"
   

   Se aparecer o arquivo, ele está instalado — só falta o PATH.

2. Aperta a tecla Windows, digita "variáveis de ambiente" e abre "Editar as variáveis de ambiente do sistema".

3. Clica em "Variáveis de Ambiente...".

4. Na lista de cima (variáveis do usuário), seleciona Path e clica em "Editar...".

5. Clica em "Novo" e adiciona:

   C:\Program Files\LLVM\bin
   

6. Clica OK em todas as janelas abertas para salvar.

7. Fecha e abre um terminal novo, e testa lld-link --version de novo.

Rodando o projeto

Depois que o lld-link --version funcionar, é só rodar normalmente na pasta do projeto:

cargo run

O Cargo vai usar automaticamente o lld-link.exe como linker, conforme configurado no .cargo/config.toml.

Alternativa (não recomendada, mas funcional)

Se você não quiser lidar com essa configuração agora, é possível comentar a linha do linker no .cargo/config.toml:

[target.x86_64-pc-windows-msvc]
# linker = "lld-link.exe"

Isso faz o Rust usar o linker padrão (link.exe, do Visual Studio), que já vem com o Build Tools — só que a compilação fica mais lenta. Recomenda-se instalar o lld-link.exe corretamente sempre que possível.