global Declarar variável global
Última atualização: 2026-09-22
global Declarar variável global
global name informa que name dentro do corpo da função se refere a uma variável global de nível de módulo.
| Categoria | Palavras-chave e Instruções |
|---|---|
| Tipo | Palavra-chave / Instrução |
| Versão do Python | all |
📝 Sintaxe
global name [, name]*
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída:
2
🏷️ Palavras-chave / Instruções relacionadas
💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QConsigo ler uma variável global sem declarar `global`. Por que ainda preciso dela?
ALer é tranquilo; mas para modificar uma variável global você deve declarar `global`. Caso contrário, um `x += 1` dentro da função trata `x` como local, levantando `UnboundLocalError` ou criando silenciosamente uma variável local.
QQual é a diferença entre `global` e `nonlocal`?
A`global` refere-se a uma variável global de nível de módulo (mais externa). `nonlocal` é usado dentro de funções aninhadas e se refere a uma variável no escopo da função mais próxima; não pode apontar para uma global.
QÉ útil escrever `global` no nível superior do módulo?
ANão, e é desnecessário — o nível superior do módulo já é o escopo global, então os nomes ali são globais naturalmente. `global` só importa para declarações dentro de um corpo de função.