Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O Visual Studio oferece suporte para configurar o ambiente de desenvolvimento interativo (IDE) para desenvolvimento em Python. Pode definir opções de acordo com a sua preferência e para satisfazer necessidades específicas do ambiente de desenvolvimento. Este artigo descreve as opções disponíveis para layout e comportamento geral, depuração, diagnóstico e funcionalidades avançadas da linguagem Python.
Localização das opções em Python
As definições de configuração em Python estão disponíveis na barra de ferramentas Visual Studio, nasOpções de >. O diálogo Opções lista a maioria das definições para Python no separador Python :
Pode configurar preferências para depuração, análise do servidor de linguagem Pylance, os ambientes conda, o ambiente geral e Janelas Interativas.
O diálogo Opções lista outras definições de Python em Editor de Texto>Python. Existem opções para barras de scroll, separadores e formatação, juntamente com definições gerais e avançadas. Outras definições estão disponíveis emFontes e Cores> para o grupo de definições do Editor de Texto.
Observação
O diálogo Opções pode incluir um separador ou grupo Experimental para funcionalidades em desenvolvimento que não são descritas neste artigo. Pode encontrar mais informações em publicações sobre o blogue de engenharia Python na Microsoft.
Opções específicas para Python
No Ferramentas>Opções>Python, pode definir opções específicas de Python para o ambiente geral, incluindo Janelas Interativas, ambientes conda, depuração, entre outros.
Opções gerais de Python
As seguintes opções estão disponíveis emFerramentas>>Opções Python>Geral:
| Opção | Predefinido | Description |
|---|---|---|
| Mostrar a Janela de Saída ao criar ambientes virtuais | On | Limpar para evitar que a janela de Saída apareça. |
| Mostrar a janela de saída ao instalar ou remover pacotes | On | Limpar para evitar que a janela de Saída apareça. |
| Mostrar barra de notificações para criar ambientes | On | Quando definido e ao abrires um projeto com um ficheiro requirements.txt ou environment.yml, o Visual Studio apresenta uma barra de informação com sugestões para criar um ambiente virtual ou um ambiente conda, respetivamente, em vez de usar o ambiente global padrão. |
| Mostrar barra de notificações para instalar pacotes | On | Quando definido e abres um projeto com um ficheirorequirements.txt que não usa o ambiente global predefinido), o Visual Studio compara esses requisitos com pacotes instalados no ambiente atual. Se faltar algum pacote, o Visual Studio mostra um aviso para instalar essas dependências. |
| Mostrar barra de notificações para configurar o framework de teste | On | Quando definido, se o Visual Studio detetar ficheiros no seu projeto Python que possam conter testes mas nenhum framework de testes estiver ativado, o Visual Studio pede-lhe para ativar pytest ou unittest. |
| Execute sempre gestores de pacotes como administrador | Off | Assegura a elevação de pip install e de operações de gestores de pacotes semelhantes em todos os ambientes. Quando instala pacotes, o Visual Studio solicita privilégios de administrador se o ambiente estiver localizado numa área protegida do sistema de ficheiros, como c:\Program Files. Nesse prompt, podes escolher sempre elevar o comando de instalação apenas para esse ambiente. Para mais informações, consulte o separador Pacotes. |
Opções de ambientes Conda
As seguintes opções estão disponíveis em Tools>Options>Python>Conda:
| Opção | Predefinido | Description |
|---|---|---|
| Caminho executável Conda | (em branco) | Define um caminho exato para o executável conda.exe em vez de depender da instalação padrão do Miniconda incluída no ambiente de trabalho Python. Se outro caminho for indicado aqui, ele tem precedência sobre a instalação padrão e quaisquer outros executáveis conda.exe especificados no registo. Podes mudar esta definição se instalares manualmente uma versão mais recente do Anaconda ou Miniconda, ou se quiseres usar uma distribuição de 32 bits em vez da distribuição padrão de 64 bits. |
Opções de depuração
As seguintes opções estão disponíveis em Ferramentas>Opções>Python>Depuração:
| Opção | Predefinido | Description |
|---|---|---|
| Avise antes de executar quando existem erros presentes | On | Quando esta opção está definida, o Visual Studio pede-te para confirmares que queres executar código com erros. Para desativar o aviso, desative esta opção. |
|
Aguardar entrada quando o processo terminar de forma anormal Aguarde entrada após o processo encerrar-se normalmente |
Ativado (para ambos) | Um programa Python iniciado no Visual Studio corre na sua própria janela de consola. Por defeito, a janela espera que pressiones uma tecla antes de a fechar, independentemente de como o programa sai. Para remover esse prompt e fechar a janela automaticamente, apague uma ou ambas estas opções. |
| Redirecionar a saída do programa Tee para a janela de Saída de Depuração | On | Apresenta a saída do programa tanto numa janela separada da consola como na janela de Saída do Visual Studio. Desative esta opção para mostrar a saída apenas na janela separada da consola. |
| Quebrar na exceção SystemExit com código de saída igual a zero | Off | Se definido, o depurador para nesta exceção. Quando limpo, o depurador sai sem falhar. |
| Ativar a depuração da biblioteca padrão Python | Off | Permite aceder ao código-fonte padrão da biblioteca durante a depuração, mas aumenta o tempo que o depurador demora a arrancar. |
| Mostrar valor de retorno da função | On | Apresenta os valores de retorno da função na janela Locals ao passar por cima de uma chamada de função no depurador (F10) |
| Variáveis de mostrar | On | Mostra quatro grupos de variáveis a mostrar e como formatar o ecrã (Agrupar, Ocultar, Inline). - Classe: O padrão é "Grupo" - Protegido: O padrão é Inline" - Função: O padrão é "Group" - Especial: O padrão é "Grupo" |
Opções de análise
As seguintes opções estão disponíveis sob Ferramentas>Opções>Python>Análise:
| Opção | Predefinido | Description |
|---|---|---|
| Modo de diagnóstico | Apenas ficheiros abertos | Especifica que ficheiros de código o servidor de linguagem analisa para problemas, incluindo Workspace e apenas ficheiros abertos. |
| Nível de log | Informação | Especifica o nível de registo a realizar pelo servidor de linguagem. Os possíveis níveis de registo, no aumento do nível de informação fornecida, incluem Erro, Aviso, Informação e Rastreio. |
| Verificação de tipos | Off | Especifica o nível de análise de verificação de tipos a realizar: - Desligado: Produz importações/diagnósticos de variáveis não resolvidas, mas não realiza análises de verificação de tipos - Básico: Use regras não relacionadas a tipos (todas as regras em nível Off) e também regras básicas de verificação de tipos - Estrito: Use todas as regras de verificação de tipos com a maior gravidade de erro, incluindo todas as regras ativadas tanto nos níveis Off como Basic |
| Formato de importação | Absoluto | Define o formato padrão ao importar módulos automaticamente, incluindo Absoluto ou Relativo. |
| Caminho dos esboços | <Vazio> | Especifica um caminho para um diretório que contém stubs de tipos personalizados. Espera-se que os ficheiros de tipo stub de cada pacote estejam no seu próprio subdiretório. |
| Caminhos de pesquisa | <Vazio> | Especifica caminhos de pesquisa para resolução de importações. Aceita caminhos especificados como cadeias e separados por vírgulas se existirem múltiplos caminhos, como ["path 1","path 2"]. |
| Caminhos tipografados | <Vazio> | Especifica caminhos para o Visual Studio usar ficheiros Typeshed personalizados em vez da versão fornecida. |
| Adicionar automaticamente caminhos de pesquisa comuns como 'src' | On | Indica se deve adicionar automaticamente caminhos de pesquisa com base em nomes pré-definidos, como src. |
| A Index instalava bibliotecas de terceiros e ficheiros de utilizador para funcionalidades de linguagem como autoimportação, importação de adiciones, símbolos de espaço de trabalho, etc. | Off | Especifica se o servidor de linguagem deve indexar ficheiros de utilizador e bibliotecas de terceiros instaladas no arranque. O índice oferece um conjunto mais completo de símbolos nas funcionalidades, incluindo importações automáticas, correções rápidas (Quick Fixes), autocompletamentos, entre outros. - Quando definido, o Visual Studio indexa os símbolos de nível superior dos pacotes instalados, como símbolos em all no package/__init__.py, juntamente com todos os símbolos de até 2.000 ficheiros de utilizadores. - Quando não está definido, o Visual Studio mostra símbolos referenciados ou usados em ficheiros previamente abertos ou carregados pelo editor. |
Opções de janelas interativas
As seguintes opções estão disponíveis emOpções>de Ferramentas>Python>Interactive Windows:
| Opção | Predefinido | Description |
|---|---|---|
| Scripts | não aplicável | Especifica uma pasta geral para scripts de arranque a aplicar ao Windows Interativo para todos os ambientes. Para mais informações, consulte Scripts de arranque. Nota: Esta funcionalidade pode não funcionar na sua versão do Visual Studio. |
| Setas para cima e para baixo navegam no histórico | On | Usa as setas para navegar pelo histórico na janela Interativa . Desative esta configuração para usar as teclas de seta para navegar dentro da saída da janela Interativa em vez disso. |
| Modo de conclusão | Avalia apenas expressões sem chamadas de função | O processo de determinar os membros disponíveis numa expressão na janela Interativa pode exigir a avaliação da expressão inacabada atual, o que pode resultar em efeitos secundários ou funções a serem chamados várias vezes. A definição padrão, Avaliar apenas expressões sem chamadas de função , exclui expressões que parecem chamar uma função, mas avalia outras expressões. Por exemplo, avalia a afirmação a.b mas não a a().b afirmação.
Impedir a avaliação de expressões evita todos os efeitos colaterais, utilizando apenas o motor padrão do IntelliSense para sugestões.
Avalie todas as expressões e avalie a expressão completa para obter sugestões, independentemente dos efeitos secundários. |
| Ocultar sugestões de análise estática | Off | Quando definido, mostra apenas sugestões obtidas ao avaliar a expressão. Se combinado com o valor do modo de ConclusãoNunca avaliar expressões, não aparecem preenchimentos úteis na janela Interativa . |
Opções de editor de texto para Python
Em Editor>de Texto Python, existem opções para barras de scroll, separadores e formatação, juntamente com definições gerais e avançadas:
Opções gerais de editor Python
As seguintes opções estão disponíveis em Ferramentas>Opções>Editor>de Texto Python>Geral de Python:
| Opção | Predefinido | Description |
|---|---|---|
| Membros da lista automática | On | Defina esta opção para listar automaticamente os membros para a conclusão das instruções de código. |
| Ocultar membros avançados | On | Quando a opção Lista Automática de membros estiver ativada, defina esta opção para ocultar membros avançados das sugestões de conclusão. Os membros avançados são aqueles que são usados com menos frequência do que outros. |
| Informação de parâmetros | On | Quando definido, passar o rato sobre os parâmetros mostra informações detalhadas, como a definição do item e ligações para a documentação. |
| Ativar o espaço virtual | On | Quando definido, insere espaços no final de cada linha de código. Selecione esta opção para posicionar os comentários num ponto consistente ao lado do seu código. O modo Espaço Virtual está ativado no modo de Seleção de Colunas . Quando o modo Virtual Space não está ativado, o ponto de inserção move-se do final de uma linha diretamente para o primeiro carácter da linha seguinte. Nota: Esta opção é influenciada pela configuração global Editor de Texto>para Todas as Línguas>Geral>Ativar o espaço virtual. Se a definição global não estiver ativada, esta opção não pode ser ativada ao nível da língua. |
| Word wrap | Off | Defina esta opção para permitir que linhas longas de código se enrolem com base na largura da viewport do editor. |
| Mostrar glifos visuais para word wrap | Off | Quando a opção Word wrap estiver ativada, defina esta opção para mostrar glifos visuais. |
| Números de linha | Off | Defina esta opção para mostrar os números das linhas na margem esquerda do editor para cada linha de código. |
| Ativar navegação por URL com um clique | On | Quando definido, pode clicar num URL para navegar até à localização alvo. |
| Barra de navegação | Off | Defina esta opção para ativar as caixas suspensas no topo da janela de código. Estes campos ajudam-no a navegar até ao código numa base de código, onde pode escolher um tipo ou membro para aceder diretamente. Nota: Esta opção é influenciada pela definição global do Editor>de Texto>de Todas as Línguas>GeralAtivar a barra de navegação. Para mais informações, consulte a barra de navegação do código> Navegar. |
| Conclusão automática do suporte | On | Quando definido, o Visual Studio adiciona automaticamente a chaveta de fecho para toda a chaveta aberta ao introduzir código. |
| Aplique cortar ou copiar em linhas em branco quando não houver seleção | On | Por defeito, o Visual Studio corta ou copia toda a linha de código quando não há seleção explícita. Use esta opção para ativar ou desativar este comportamento de Cortar ou Copiar quando invocado em linhas em branco. |
Para mais informações, consulte a caixa de diálogo Opções: Editor de > Texto Geral.
Opções avançadas de editor Python
As seguintes opções estão disponíveis em Ferramentas>Opções>Editor>de Texto Python>Avançado:
| Opção | Predefinido | Description |
|---|---|---|
| Ofertas de auto-importação concluídas | On | Quando definido, o Visual Studio oferece importações automáticas em completações. |
| Adicionar automaticamente parênteses para funções | Off | Quando definido, o Visual Studio adiciona automaticamente colchetes para funções à medida que introduz código no editor. |
Opções de fontes e cores
Outras opções de Python estão disponíveis em Ambiente>Fontes e Cores quando o grupo Editor de Texto está definido para Python:
Os nomes das opções em Python têm todos o prefixo "Python" e são autoexplicativos. A fonte padrão para todos os temas de cor do Visual Studio é de 10 pt Consolas regular (não negrito). As cores padrão variam consoante o tema. Normalmente, mudas uma fonte ou cor para facilitar a leitura do texto.