⚠ Ficheiros duplicados após sync não são erro do OneDrive

Se vê ficheiros como relatorio.docx e relatório.docx em simultâneo após sincronizar entre Mac e Windows, a causa é quase sempre codificação Unicode — o mesmo nome, representado por bytes diferentes, é tratado como dois ficheiros distintos pelo serviço de sync.

Neste artigo

1. NFD vs NFC: a causa técnica do problema
2. Problemas concretos em sincronização
3. Caracteres proibidos no Windows NTFS
4. Boas práticas preventivas por serviço
5. Script Python: normalizar pastas no macOS
6. Configuração Git para ambientes mistos
7. Problemas comuns e resolução

# Caracteres PROIBIDOS no Windows NTFS (válidos no macOS)
\  /  :  *  ?  "  <  >  |

# Nomes reservados pelo Windows (mesmo sem extensão)
CON  PRN  AUX  NUL  COM1-COM9  LPT1-LPT9

# Outros problemas comuns
. nome          # ponto inicial = oculto no macOS/Linux, visível no Windows
nome.           # ponto final = inválido no Windows
nome com espaço # espaços no início ou fim do nome

# Caracteres adicionais proibidos no SharePoint Online
~  #  %  &  *  {  }  '  "

# SEGUROS: sem acentos, sem caracteres especiais
relatorio-financeiro-2024.xlsx
configuracao-vpn.docx
reuniao-equipa-marco-2024.pptx

# PROBLEMÁTICOS: acentos + caracteres especiais NTFS
relatório financeiro: Q1/2024.xlsx   # acentos + dois pontos + barra
configuração VPN?.docx               # acento + ponto de interrogação
Reunião equipa — março 2024.pptx     # acento + em dash

# Activar suporte a caminhos longos no Windows (PowerShell como admin)
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1

# Via Group Policy (para domínios AD):
# Computer Configuration → Administrative Templates → System → Filesystem
# → Enable Win32 long paths → Enabled

🛑 O erro já aconteceu? Faz backup antes de qualquer acção

Se tens ficheiros duplicados, nomes corrompidos ou itens em falta depois de uma sincronização, não tentes corrigir imediatamente. A renomeação em massa é irreversível — um conflito não detectado pode sobrepor dados. O procedimento seguro é:

1. Pausar a sincronização do OneDrive / Dropbox / Google Drive antes de tocar em qualquer ficheiro
2. Fazer backup completo da pasta afectada para um destino externo (Time Machine, disco externo ou cópia manual para outra localização)
3. Verificar o backup antes de continuar — confirmar que todos os ficheiros estão acessíveis na cópia
4. Só depois executar o script com --dry-run para avaliar as alterações
5. Aplicar as alterações e reactivar a sincronização apenas após validar o resultado

📌 Opção rápida de backup no macOS antes de executar o script:
cp -R ~/Documents/Projecto ~/Desktop/Projecto_backup_$(date +%Y%m%d)

💡 Executar sempre –dry-run primeiro

O modo de simulação mostra todas as alterações que seriam feitas sem renomear nada. É a forma segura de validar o resultado antes de aplicar. O script pede confirmação explícita antes de qualquer alteração real e detecta conflitos de nomes automaticamente.

# Passo 1: Simular sem alterar nada (sempre primeiro)
python3 fix_accents.py ~/Documents/Projecto --dry-run

# Passo 2: Aplicar as alterações (pede confirmação)
python3 fix_accents.py ~/Documents/Projecto

# Com log de todas as alterações para ficheiro
python3 fix_accents.py ~/Documents/Projecto --log alteracoes.txt

# Manter maiúsculas/minúsculas originais (por omissão converte para minúsculas)
python3 fix_accents.py ~/Documents/Projecto --no-lowercase

#!/usr/bin/env python3
# fix_accents.py — Remove acentos e caracteres especiais de nomes de
# ficheiros e pastas para compatibilidade macOS/Windows (NFD → ASCII seguro)
# Não requer dependências externas — funciona com Python 3 nativo do macOS

import os, sys, re, unicodedata, argparse, logging
from pathlib import Path
from datetime import datetime

# Mapeamento de caracteres especiais sem equivalente ASCII directo
EXTRA_MAP = {
    '–': '-',   # en dash
    '—': '-',   # em dash
    'ª': 'a',   # ordinal feminino ª
    'º': 'o',   # ordinal masculino º
    'ß': 'ss',  # ß
    'æ': 'ae',  # æ
    'ø': 'o',   # ø
    '…': '.',   # reticências …
}
NTFS_FORBIDDEN = r'[\/:*?"<>|]'

def slugify_name(name, lowercase=False):
    if name.startswith('.'): return name  # preservar ficheiros ocultos
    stem, *ext = name.rsplit('.', 1) if '.' in name else (name,)
    ext = ('.' + ext[0]) if ext else ''
    r = unicodedata.normalize('NFC', stem)
    for src, dst in EXTRA_MAP.items(): r = r.replace(src, dst)
    r = unicodedata.normalize('NFD', r)
    r = ''.join(c for c in r if unicodedata.category(c) != 'Mn')
    r = re.sub(NTFS_FORBIDDEN, '', r)
    r = re.sub(r'[\s]+', '-', r)
    r = re.sub(r'[^\w\-.]', '', r)
    r = re.sub(r'-{2,}', '-', r).strip('-').strip('.') or 'ficheiro'
    if lowercase: r, ext = r.lower(), ext.lower()
    return r + ext

def process_directory(root, dry_run, lowercase, logger):
    renamed = errors = unchanged = 0
    for dirpath, dirnames, filenames in os.walk(root, topdown=False):
        cur = Path(dirpath)
        for name in filenames + dirnames:
            if name in ('.DS_Store', '.localized') or name.startswith('._'):
                continue
            new = slugify_name(name, lowercase)
            if new == name: unchanged += 1; continue
            old_p, new_p = cur / name, cur / new
            if new_p.exists() and new_p != old_p:
                print(f'  CONFLITO  {name} → {new} (ignorado)'); errors += 1; continue
            if dry_run:
                print(f'  DRY-RUN  {name}  →  {new}'); renamed += 1
            else:
                try: old_p.rename(new_p); print(f'  OK  {name}  →  {new}'); renamed += 1
                except Exception as e: print(f'  ERRO  {name}: {e}'); errors += 1
    return renamed, errors, unchanged

def main():
    p = argparse.ArgumentParser()
    p.add_argument('path'); p.add_argument('--dry-run', action='store_true')
    p.add_argument('--no-lowercase', action='store_true'); p.add_argument('--log')
    args = p.parse_args()
    root = Path(args.path).expanduser().resolve()
    if not root.is_dir(): print(f'Erro: {root} não é uma pasta'); sys.exit(1)
    logger = logging.getLogger('fix_accents')
    if args.log:
        fh = logging.FileHandler(args.log, encoding='utf-8')
        fh.setFormatter(logging.Formatter('%(asctime)s %(levelname)s %(message)s'))
        logger.addHandler(fh); logger.setLevel(logging.DEBUG)
    print(f'
Pasta: {root}')
    print(f'Modo: {"DRY-RUN" if args.dry_run else "REAL"}
')
    if not args.dry_run:
        r = input('ATENÇÃO: operação irreversível. Tens backup? (s/N): ').strip().lower()
        if r not in ('s','sim','y','yes'): print('Cancelado.'); sys.exit(0)
    renamed, errors, unchanged = process_directory(root, args.dry_run, not args.no_lowercase, logger)
    print(f'
{"Seriam renomeados" if args.dry_run else "Renomeados"}: {renamed}')
    print(f'Sem alterações: {unchanged} | Erros/Conflitos: {errors}
')

if __name__ == '__main__': main()

# Aplicar globalmente em todos os repositórios Git do Mac
git config --global core.precomposeunicode true   # força NFC nos nomes de ficheiros
git config --global core.quotepath false            # mostra acentos no terminal sem escape

# Verificar a configuração actual
git config --global --list | grep -E "unicode|quote"

# Para um repositório específico já existente
cd /caminho/para/repositorio
git config core.precomposeunicode true

# Detectar ficheiros NFD no repositório (mostra nomes com escape Ã\...)
git ls-files | cat -v | grep '\\'

# Verificar se o .gitattributes está a normalizar correctamente
# Adicionar ao .gitattributes do projecto:
* text=auto eol=lf

✓ Checklist para ambientes mistos macOS / Windows

• Se o erro já ocorreu: pausar a sync, fazer backup completo da pasta afectada antes de qualquer acção — cp -R ~/pasta ~/Desktop/pasta_backup_$(date +%Y%m%d)
• Política de equipa: nomes de ficheiros sem acentos e sem caracteres especiais NTFS
• git config --global core.precomposeunicode true em todos os Macs
• NAS Synology: SMB com Support unicode NFD encoding activado
• SharePoint: verificar limite de 400 caracteres no caminho total
• Windows: activar Long Path Support (LongPathsEnabled = 1)
• Executar fix_accents.py --dry-run antes de qualquer migração de ficheiros

Artigos relacionados no kbase.pt

• DNS: Guia Completo de Registos para Sysadmins
• OneDrive e SharePoint: Resolver Problemas de Sincronização
• Active Directory: Diagnóstico e Resolução de Problemas Comuns
• M365 Licenciamento: Guia Completo para PME

Leituras complementares