Como ativar o suporte a caminhos longos no registro do Windows 11
🔍 WiseChecker

Como ativar o suporte a caminhos longos no registro do Windows 11

Solução rápida: abra o Editor do Registro, navegue até HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem, defina o DWORD LongPathsEnabled como 1, reinicie — o Windows 11 agora suporta caminhos de até 32.767 caracteres em aplicativos modernos.

Você encontrou o limite de 260 caracteres ao copiar arquivos, extrair arquivos compactados ou trabalhar com estruturas de pastas profundamente aninhadas (node_modules, clientes de sincronização fazendo backup de outros sistemas). O Windows 10 1607+ oferece suporte a caminhos longos, mas esse suporte é opcional. O único valor do registro ativa o recurso em todo o sistema para aplicativos que se declaram compatíveis com caminhos longos — e o File Explorer no Windows 11 é um deles.

Sintoma: arquivos não podem ser criados, copiados ou acessados quando o caminho excede 260 caracteres.
Afeta: Windows 11 (e Windows 10 1607+) por padrão até que a opção de caminho longo seja ativada.
Tempo de correção: ~5 minutos incluindo reinicialização.

ADVERTISEMENT

O que causa isso

A API histórica do Windows usava uma constante MAX_PATH = 260 como comprimento máximo de uma string de caminho. O próprio NTFS suporta caminhos de até 32.767 caracteres, mas a API Win32 trunca em MAX_PATH a menos que um aplicativo opte explicitamente pelo suporte a caminhos longos. O Windows 10 versão 1607 adicionou uma opção de sistema que, quando ativada, permite que aplicativos que optaram pelo recurso manipulem caminhos completos. Os aplicativos ainda precisam declarar que são compatíveis com caminhos longos em seu manifesto — a maioria dos modernos faz isso, mas aplicativos legados não.

Método 1: Ativar via Editor do Registro (compatível com Home)

Funciona em todas as edições do Windows 11.

  1. Pressione Win + R, digite regedit, pressione Enter.
  2. Navegue até HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem.
  3. Encontre o DWORD LongPathsEnabled. Se não existir, crie-o:
    • Clique com o botão direito no painel direito → Novo → Valor DWORD (32 bits).
    • Nomeie como LongPathsEnabled.
  4. Clique duas vezes no valor. Defina como 1. Clique em OK.
  5. Feche o Editor do Registro.
  6. Reinicie. O suporte a caminhos longos agora está ativo em todo o sistema.

A reinicialização é necessária porque o subsistema FileSystem lê a opção na inicialização, não em cada operação de arquivo.

ADVERTISEMENT

Método 2: Ativar via PowerShell (roteirizável)

Para scripts de implantação ou configuração rápida via script.

  1. Abra o Terminal (Admin).
  2. Defina o valor do registro:
    New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWord -Force
  3. Verifique:
    Get-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled"

    O valor deve ser 1.

  4. Reinicie.

Mesmo efeito do Método 1, mais rápido para automação de TI.

Método 3: Ativar via Política de Grupo (Pro/Enterprise)

Para ambientes gerenciados e implantação via Política de Grupo.

  1. Pressione Win + R, digite gpedit.msc, pressione Enter.
  2. Navegue até Configuração do Computador → Modelos Administrativos → Sistema → Sistema de Arquivos.
  3. Encontre Ativar caminhos longos do Win32.
  4. Clique duas vezes. Defina como Ativado. Clique em Aplicar → OK.
  5. Execute gpupdate /force no Terminal elevado.
  6. Reinicie.

Esta é a maneira mais limpa para organizações — a mesma política pode ser enviada via Console de Gerenciamento de Política de Grupo para todos os PCs do domínio.

ADVERTISEMENT

Como verificar se a correção funcionou

  • Crie uma estrutura de pastas profundamente aninhada que exceda 260 caracteres no caminho total. Copie um arquivo para dentro dela. A cópia deve ser bem-sucedida.
  • Abra o arquivo de caminho longo no Bloco de Notas — salva e abre corretamente.
  • Execute (Get-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name LongPathsEnabled).LongPathsEnabled no PowerShell. Retorna 1.
  • Extraia um arquivo compactado com caminho longo (por exemplo, um projeto Node.js com node_modules) — a extração é concluída sem truncamento.

Se nada disso funcionar

Se os caminhos longos ainda falharem após ativar a opção do registro e reiniciar, o aplicativo que você está usando não é compatível com caminhos longos. Três casos. Bloco de Notas: funciona com caminhos longos desde o Windows 10 1809. Se o seu Bloco de Notas falhar em caminhos longos, você pode estar usando uma versão Win32 antiga — use o Bloco de Notas da Microsoft Store ou o novo aplicativo Bloco de Notas fornecido com o Windows 11. Aplicativos de terceiros antigos: muitos aplicativos Win32 antigos (Outlook 2010, Office 2013, produtos Adobe antigos) não declaram compatibilidade com caminhos longos mesmo com a opção do sistema ativada. Solução alternativa: use um caminho mais curto. Mova a pasta profundamente aninhada para mais perto da raiz da unidade (por exemplo, de C:\Usuários\você\Documentos\Projetos\... para C:\P\ + subpastas). Sistema de arquivos de destino: copiar para FAT32 (a maioria dos pendrives por padrão) limita caminhos a 260 caracteres independentemente da opção do sistema. Reformate para exFAT ou NTFS. Para ferramentas de compilação e fluxos de trabalho de desenvolvimento, use o prefixo \\?\ em caminhos completos em seus scripts — ignora a normalização completamente.

Conclusão: O suporte a caminhos longos é um único DWORD do registro mais reinicialização — ative a opção e o File Explorer, aplicativos modernos e ferramentas de desenvolvimento começarão a lidar com caminhos de até 32.767 caracteres.

ADVERTISEMENT