Corrigir erros de caminho longo ao copiar pastas profundamente aninhadas no Windows 11
🔍 WiseChecker

Corrigir erros de caminho longo ao copiar pastas profundamente aninhadas no Windows 11

Solução rápida: abra o Editor de Política de Grupo (gpedit.msc) → Configuração do Computador → Modelos Administrativos → Sistema → Sistema de Arquivos e ative Habilitar caminhos longos do Win32. Na edição Home, defina o DWORD LongPathsEnabled como 1 em HKLM\SYSTEM\CurrentControlSet\Control\FileSystem.

Você tenta copiar uma estrutura de pastas profundamente aninhada e o Windows diz: O(s) nome(s) de arquivo seria(m) muito longo(s) para a pasta de destino. Até o Explorador de Arquivos não consegue abrir o arquivo. Alguns aplicativos funcionam, outros não. A causa é o limite de 260 caracteres no caminho que o Windows carrega desde os primórdios. O Windows 10 1607+ oferece suporte a caminhos longos, mas requer uma configuração no sistema e a conscientização por aplicativo.

Sintoma: A cópia ou renomeação de arquivo falha com “O(s) nome(s) de arquivo seria(m) muito longo(s)” ou “Caminho muito longo.” Afeta árvores de pastas profundamente aninhadas (geralmente de node_modules, clientes de sincronização ou backups de outros sistemas).
Afeta: Windows 11 (e Windows 10 1607+) quando o caminho combinado excede 260 caracteres.
Tempo de correção: ~5 minutos.

ADVERTISEMENT

O que causa isso

A API Win32 do Windows historicamente limitava os caminhos a MAX_PATH = 260 caracteres (letra da unidade + dois pontos + barra invertida + nomes de pastas/arquivos + terminador nulo). O próprio sistema de arquivos NTFS suporta caminhos de até 32.767 caracteres, mas a API Win32 trunca qualquer coisa maior no nível da API. O Windows 10 1607 introduziu o sinalizador de manifesto long path aware — os aplicativos podem optar por receber caminhos de até 32.767 caracteres. A chave no sistema operacional ativa esse suporte; o suporte por aplicativo exige que o aplicativo também opte por isso.

O Explorador de Arquivos no Windows 11 oferece suporte a caminhos longos por padrão assim que a chave do sistema é ativada. Aplicativos mais antigos não — você pode precisar usar alternativas de cópia como robocopy ou 7-Zip para esses.

Método 1: Ativar suporte a caminhos longos via Política de Grupo (Pro/Enterprise)

A correção padrão nas edições Pro e superiores.

  1. Pressione Win + R, digite gpedit.msc, pressione Enter.
  2. Navegue até Configuração do Computador → Modelos Administrativos → Sistema → Sistema de Arquivos.
  3. No painel direito, encontre Habilitar caminhos longos do Win32.
  4. Clique duas vezes. Defina como Habilitado. Clique em Aplicar → OK.
  5. Execute gpupdate /force em um Prompt de Comando elevado.
  6. Reinicie para que a alteração seja totalmente aplicada.
  7. Tente a cópia ou renomeação que falhava — o Explorador de Arquivos e aplicativos modernos agora devem lidar com caminhos de até 32.767 caracteres.

Esta é a correção mais limpa para usuários Pro.

ADVERTISEMENT

Método 2: Ativar via Registro (compatível com Home)

Alteração equivalente para Windows 11 Home, onde o Editor de Política de Grupo não está disponível.

  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.
  4. Defina o valor como 1.
  5. Feche o Editor do Registro.
  6. Reinicie.
  7. O suporte a caminhos longos agora está ativado em todo o sistema.

Funciona em todas as edições do Windows 11. O valor do registro é o mecanismo subjacente usado pela Política de Grupo.

Método 3: Usar robocopy ou 7-Zip para a cópia imediata

Quando você precisa copiar uma pasta de caminho longo agora e não pode reiniciar, ou quando um aplicativo antigo se recusa a lidar com caminhos longos mesmo com a chave do sistema ativada.

  1. Abra o Terminal (Admin).
  2. Use robocopy para a operação de cópia:
    robocopy "C:\origem\pasta\profunda\aninhada" "D:\destino" /E /COPY:DAT /R:3 /W:5

    As opções: /E copia subdiretórios incluindo vazios; /COPY:DAT preserva Dados, Atributos, Carimbos de data/hora; /R:3 tenta novamente 3 vezes; /W:5 aguarda 5 segundos entre tentativas.

  3. O robocopy lida internamente com caminhos de até ~32.000 caracteres. O destino deve estar em um sistema de arquivos que também suporte caminhos longos (NTFS suporta; FAT32 não).
  4. Alternativa: instale o 7-Zip. Use-o para compactar a pasta de caminho longo em um arquivo .7z. O arquivo pode ser copiado com segurança; extraia em um destino com suporte a caminhos longos ativado.
  5. Para manipulação interativa de arquivos de caminho longo, instale o Far Manager ou Total Commander — ambos lidam com caminhos longos nativamente sem exigir a chave do sistema.

Essas ferramentas funcionam antes da correção no nível do sistema ou junto com ela.

ADVERTISEMENT

Como verificar se a correção funcionou

  • Crie um caminho de teste: abra o Explorador de Arquivos, crie pastas aninhadas para exceder 260 caracteres no total.
  • Tente copiar um arquivo para a pasta mais profunda. A cópia deve ser bem-sucedida.
  • Abra o arquivo de caminho longo no Bloco de Notas. O arquivo abre e salva corretamente.
  • Execute Get-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name LongPathsEnabled no PowerShell. O valor deve ser 1.

Se nenhum desses funcionar

Se os caminhos longos ainda falharem após ativar a chave do sistema, três causas se aplicam. Aplicativo não compatível com caminhos longos: o aplicativo específico que você está usando não se declara como compatível com caminhos longos em seu manifesto. Não há correção do seu lado — o aplicativo precisa de uma atualização do fornecedor. Solução alternativa: copie ou renomeie via Explorador de Arquivos (que é compatível com caminhos longos) ou via robocopy. Limite do sistema de arquivos de destino: copiar para uma unidade USB FAT32 limita os caminhos a 260 caracteres independentemente da chave do sistema. Reformate a unidade para exFAT ou NTFS, ambos suportam caminhos longos. Limite de travessia de caminho: o prefixo \\?\ em caminhos completos ignora a normalização, mas funciona apenas com chamadas explícitas — a maioria dos aplicativos GUI não o usa. Tente copy "\\?\C:\caminho\muito\longo\arquivo.txt" "\\?\D:\destino" no Terminal para verificar se o NTFS subjacente suporta a operação.

Conclusão: O Windows 11 suporta caminhos de até 32.767 caracteres — mas o suporte é opcional. Ative a chave no Registro ou na Política de Grupo, reinicie, e o Explorador de Arquivos mais aplicativos modernos param de encontrar o limite de 260 caracteres.

ADVERTISEMENT