O que é o formato de ficheiro PYW?
Um arquivo .pyw é um script de código-fonte Python que é executado sem abrir uma janela de console no Windows. Sintaticamente, é idêntico a um arquivo .py padrão - código-fonte Python UTF-8 válido. A distinção está inteiramente na extensão: o Windows associa .pyw ao pythonw.exe, o interpretador Python sem janela, em vez do python.exe padrão. Quando um arquivo .pyw é iniciado, nenhuma janela de terminal aparece, tornando-o ideal para aplicações GUI construídas com tkinter, wxPython ou PyQt/PySide, e para scripts silenciosos em segundo plano.
A convenção .pyw foi estabelecida junto com as primeiras versões do CPython para Win32 em meados da década de 1990 e foi formalizada pela PEP 397 (Python Launcher for Windows), incluída no Python desde a versão 3.3. O Python Launcher (py.exe / pyw.exe) lê a extensão do arquivo para selecionar o interpretador apropriado.
No macOS, algumas distribuições Python fornecem um binário pythonw para integração com a GUI Aqua, mas o .pyw é menos comumente usado lá. No Linux, a extensão não carrega nenhum significado especial - a supressão do console é tratada pelo nohup, desvinculação de processo ou pelo próprio kit de ferramentas GUI.
Um arquivo .pyw pode começar com um shebang (#!/usr/bin/env python3) ou uma declaração de codificação (# -*- coding: utf-8 -*-), mas nenhum deles é obrigatório. Renomear qualquer .pyw para .py e executá-lo com python.exe sempre funciona; uma janela de console aparecerá nesse caso.
Segurança e proteção
RISCO: MEDIUMUm arquivo .pyw é um código Python executável que roda silenciosamente sem uma janela de console, tornando scripts maliciosos mais difíceis de detectar (sem terminal visível). Trate arquivos .pyw de fontes desconhecidas da mesma forma que qualquer executável desconhecido. Revise o código-fonte em um editor de texto antes de executá-lo. O Python deve estar instalado para que o arquivo seja executado; sem o Python, o arquivo é inofensivo.
Detalhes do formato
em resumoProgramas que abrem arquivos PYW
pythonw.exe (sem console). Para editar, clique com o botão direito > Editar com IDLE. pythonw.exe se a supressão do console for necessária durante a depuração. pythonw.exe (sem console). Para editar, clique com o botão direito > Editar com IDLE. pythonw.exe (sem console). Para editar, clique com o botão direito > Editar com IDLE. Detalhes técnicos
especificação profunda| Execução no Windows | Iniciado pelo `pythonw.exe` - o interpretador CPython sem janela; nenhuma janela de console é alocada ou herdada |
| Sintaxe | Idêntica ao `.py` - código-fonte Python 3 (ou Python 2) válido; a extensão é a única distinção funcional |
| Codificação | Texto simples UTF-8; BOM permitido, mas não recomendado (PEP 8) |
| Registro de tipo de arquivo no Windows | `.pyw` mapeado para `pythonw.exe` via registro do Windows (`HKEY_CLASSES_ROOT\.pyw`) |
| Suporte ao Python Launcher | PEP 397 `py.exe` / `pyw.exe` despacha arquivos `.pyw` para o inicializador com janela (Python 3.3+, Windows) |
| Janela de console | Nenhuma - o `pythonw.exe` descarta stdout/stderr, a menos que seja explicitamente redirecionado para um arquivo ou pipe |
| Caso de uso principal | Aplicações GUI (`tkinter`, `wxPython`, `PyQt`/`PySide`) e scripts silenciosos em segundo plano |
| Magic bytes | Nenhum - texto simples UTF-8; shebang opcional `#!/usr/bin/env python3` ou declaração de codificação na linha 1 |
| Tipo MIME | `text/x-python`; também `application/x-python` |
| Plataforma | Windows (principal); macOS via binário `pythonw` (algumas distribuições); Linux (a extensão não carrega significado especial) |
| Tamanho típico do arquivo | 1 KB - 1 MB (apenas código-fonte) |
| Compatibilidade | Renomear `.pyw` para `.py` e executar com `python.exe` sempre funciona; uma janela de console aparecerá |
| Formato relacionado | `.py` - script Python padrão; executado via `python.exe` no Windows, alocando uma janela de console |
| Lançado | circa 1994 (Python for Windows; pythonw.exe introduced in early Win32 Python builds) |
| Versão mais recente | Python 3.x (current 3.13.x as of 2025); no separate .pyw format version |
| Padrão aberto | Sim · livre de royalties |
| Especificação | docs.python.org |
Conversões de PYW
Perguntas e Respostas da Comunidade
perguntado por usuáriosAinda não há perguntas - seja o primeiro a perguntar sobre arquivos PYW.
Perguntas frequentes
Qual é a diferença entre .py e .pyw?
pythonw.exe, que suprime a janela do console. Use .pyw para aplicativos GUI; use .py para scripts que precisam de saída de terminal.Por que nada acontece quando eu clico duas vezes em um arquivo .pyw?
python.exe ou pythonw.exe.