Quais efeitos secundários podem ocorrer ao trabalhar com código em ficheiros de cabeçalho?

Inclusão múltipla: Se um mesmo ficheiro de cabeçalho for incluído várias vezes em diferentes locais da árvore de dependências, isso pode levar a erros de compilação devido a redefinições de entidades (funções, variáveis, classes). Solução: usar diretivas do pré-processador #ifndef/#define/#endif ou #pragma once.

Dependências da ordem de inclusão: Se um ficheiro de cabeçalho depende de definições de outros ficheiros de cabeçalho e estes são incluídos na ordem incorreta, podem ocorrer erros de compilação. Boa prática: incluir todas as dependências necessárias dentro do próprio ficheiro de cabeçalho.

Problemas com o âmbito de visibilidade (Poluição do espaço de nomes): Usar a diretiva using namespace num ficheiro de cabeçalho pode importar todos os nomes do espaço de nomes para todos os ficheiros que o incluam, aumentando a probabilidade de conflitos de nomes. Solução: usar nomes qualificados (std::string) ou limitar using namespace a funções ou blocos de código, não no âmbito global do ficheiro de cabeçalho.

Incorporação de código (Funções inline): Definir o corpo de uma função num ficheiro de cabeçalho (especialmente com a palavra-chave inline) pode aumentar o tamanho dos ficheiros objeto devido à duplicação de código. No entanto, isto pode ser útil para otimizar funções pequenas.

Inicialização de variáveis estáticas: Definir uma variável estática num ficheiro de cabeçalho sem inline pode causar erros de compilação devido a múltiplas definições. Para membros estáticos de classes, declarar no cabeçalho e definir num ficheiro .cpp. Para variáveis estáticas globais, evitar definir em cabeçalhos ou usar inline no C++17 e versões superiores.

Dependências de compilação ocultas: Alterar o conteúdo de um ficheiro de cabeçalho pode requerer recompilar todos os ficheiros .cpp que o incluam, mesmo que as alterações sejam menores. Isto pode atrasar o processo de compilação.

Erro ODR (Regra de uma definição): Violação da regra de uma única definição, por exemplo, definir uma função não inline ou uma variável estática não inline num ficheiro de cabeçalho incluído em múltiplos ficheiros de implementação.

Ciclos de inclusão: Quando dois ou mais ficheiros de cabeçalho incluem-se recursivamente. Isto pode causar problemas de compilação, embora as diretivas de proteção contra múltipla inclusão geralmente previnam ciclos infinitos no pré-processador.