Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Visual Studio oferece suporte para configurar o IDE (ambiente de desenvolvimento interativo) para o desenvolvimento do Python. Você pode definir opções de acordo com sua preferência e atender às 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 recursos avançados de linguagem Python.
Local das opções do Python
As configurações do Python estão disponíveis na barra de ferramentas do Visual Studio em Opções de Ferramentas>. A caixa de diálogo Opções lista a maioria das configurações do Python na guia Python :
Você pode configurar preferências para depuração, análise de servidor de linguagem Pylance, ambientes conda, ambiente geral e Windows Interativo.
A caixa de diálogo Opções lista outras configurações do Python em Editor de Texto>Python. Há opções para barras de rolagem, guias e formatação, juntamente com configurações gerais e avançadas. Outras configurações estão disponíveis emFontes e Cores do > para o grupo de configurações do Editor de Texto.
Observação
A caixa de diálogo Opções pode incluir uma guia experimental ou um grupo para recursos em desenvolvimento que não estão descritos neste artigo. Você pode encontrar mais informações em postagens sobre a engenharia do Python no blog da Microsoft.
Opções específicas para Python
Em Ferramentas>Opções>Python, você pode definir opções específicas do Python para o ambiente geral, incluindo Interactive Windows, ambientes conda, depuração e muito mais.
Opções gerais do Python
As seguintes opções estão disponíveis nasOpções>de Ferramentas>Do Python>Geral:
| Opção | Padrão | Description |
|---|---|---|
| Mostrar a Janela de Saída ao criar ambientes virtuais | Por | Desmarque a opção para impedir que a janela Saída apareça. |
| Mostrar a Janela de Saída ao instalar ou remover pacotes | Por | Desmarcar para evitar que a janela Saída apareça. |
| Mostrar a barra de notificações para criar ambientes | Por | Quando configurado, ao abrir um projeto com um arquivo requirements.txt ou environment.yml, o Visual Studio exibe uma barra de informações com sugestões para criar um ambiente virtual ou um ambiente conda, respectivamente, em vez de usar o ambiente global padrão. |
| Mostrar barra de notificações para instalar pacotes | Por | Quando definido e você abre um projeto com um arquivo requirements.txt que não usa o ambiente global padrão), o Visual Studio compara esses requisitos com pacotes instalados no ambiente atual. Se algum pacote estiver ausente, o Visual Studio exibirá um prompt para instalar essas dependências. |
| Mostrar a barra de notificações para configurar a estrutura de teste | Por | Quando definido, se o Visual Studio detectar arquivos em seu projeto Python que possam conter testes, mas nenhum framework de teste estiver habilitado, o Visual Studio solicitará que você habilite pytest ou unittest. |
| Sempre executar gerenciadores de pacotes como administrador | Desativado | Eleva sempre pip install e operações semelhantes do gerenciador de pacotes para todos os ambientes. Quando você instala pacotes, o Visual Studio solicita privilégios de administrador se o ambiente estiver localizado em uma área protegida do sistema de arquivos, como c:\Arquivos de Programas. Nesse prompt, você pode optar por sempre elevar o comando de instalação apenas para esse ambiente. Para obter mais informações, consulte a guia Pacotes. |
Opções de ambiente do Conda
As seguintes opções estão disponíveis em Ferramentas>Opções>Python>Conda:
| Opção | Padrão | Description |
|---|---|---|
| Caminho executável do Conda | (em branco) | Especifica um caminho exato para o conda.exe executável em vez de depender da instalação padrão do Miniconda incluída na carga de trabalho do Python. Se outro caminho for fornecido aqui, ele terá precedência sobre a instalação padrão e qualquer outro conda.exe executáveis especificados no registro. Você poderá alterar essa configuração se instalar manualmente uma versão mais recente do Anaconda ou do Miniconda ou quiser 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 | Padrão | Description |
|---|---|---|
| Solicitar antes de executar quando os erros estiverem presentes | Por | Quando essa opção estiver definida, o Visual Studio solicitará que você confirme se deseja executar o código que tem erros. Para desabilitar o aviso, desmarque essa opção. |
|
Aguarde a entrada quando o processo for encerrado anormalmente Aguarde a entrada quando o processo for encerrado normalmente |
Ativado (para ambos) | Um programa python iniciado pelo Visual Studio é executado em sua própria janela de console. Por padrão, a janela aguarda que você pressione uma tecla antes de fechá-la, independentemente de como o programa é encerrado. Para remover esse prompt e fechar a janela automaticamente, desmarque uma ou ambas as opções. |
| Redirecionar a saída do programa para a janela de saída de depuração | Por | Exibe a saída do programa em uma janela de console separada e na janela Saída do Visual Studio. Desmarque essa opção para mostrar a saída apenas na janela do console separada. |
| Interromper a exceção SystemExit com o código de saída zero | Desativado | Se definido, interrompe o depurador nessa exceção. Quando em um estado claro, o depurador sai sem interrupção. |
| Habilitar a depuração da biblioteca padrão do Python | Desativado | Torna possível entrar no código-fonte da biblioteca padrão durante a depuração, mas aumenta o tempo necessário para o depurador iniciar. |
| Mostrar o valor retornado da função | Por | Exibe valores retornados da função na janela Locais ao passar por uma chamada de função no depurador (F10) |
| Mostrar variáveis | Por | Exibe quatro grupos de variáveis para mostrar e como formatar a exibição (Grupo, Ocultar, Embutido). - Classe: o padrão é "Agrupar" - Protegido: Embutido por padrão - Função: O padrão é "Group" - Especial: o padrão é "Agrupar" |
Opções de análise
As seguintes opções estão disponíveis em Ferramentas>Opções>Python>Análise:
| Opção | Padrão | Description |
|---|---|---|
| Modo de diagnóstico | Abrir somente arquivos | Especifica quais arquivos de código o servidor de idioma analisa para problemas, incluindo Workspace e apenas arquivos abertos. |
| Nível de registo | Informação | Especifica o nível de log a ser executado pelo servidor de idiomas. Os níveis possíveis de registro em log, em nível crescente de informações fornecidas, incluem Erro, Aviso, Informações e Rastreamento. |
| Verificação de tipo | Desativado | Especifica o nível de análise de verificação de tipo que será executada: - Desativado: produzir diagnóstico de importações/variáveis não resolvidas, mas não realizar análise de verificação de tipo - Básico: usar regras de não-tipo (todas as regras marcadas como Off) e regras básicas relacionadas à verificação de tipo - Restrito: Use todas as regras de verificação de tipos com a maior severidade de erro, incluindo todas as regras nos níveis Desativado e Básico |
| Formato de importação | Absoluto | Define o formato padrão ao importar automaticamente módulos, incluindo Absolute ou Relative. |
| Caminho de stubs | <Vazio> | Especifica um caminho para um diretório que contém stubs de tipo personalizado. Espera-se que os arquivos de stub de tipo para cada pacote estejam em seu próprio subdiretório. |
| Caminhos de pesquisa | <Vazio> | Especifica caminhos de pesquisa para resolução de importação. Aceita caminhos especificados como cadeias de caracteres e separados por vírgulas se houver vários caminhos, como ["path 1","path 2"]. |
| Caminhos do Typeshed | <Vazio> | Especifica caminhos para o Visual Studio utilizar arquivos Typeshed personalizados em vez da versão empacotada padrão. |
| Adicionar automaticamente caminhos de pesquisa comuns, como 'src' | Por | Indica se os caminhos de pesquisa devem ser adicionados automaticamente com base em nomes predefinidos, como src. |
| Indexar bibliotecas de terceiros instaladas e arquivos de usuário para recursos de idioma, como importação automática, adição de importação, símbolos de espaço de trabalho, etc. | Desativado | Especifica se o servidor de idiomas deve indexar arquivos de usuário e bibliotecas de terceiros instaladas na inicialização. O índice fornece um conjunto mais completo de símbolos em funcionalidades, incluindo importações automáticas, Ajustes Rápidos, preenchimentos automáticos, entre outros. - Quando definido, o Visual Studio indexa os símbolos de nível superior dos pacotes instalados, como símbolos em todos sob package/__init__.py, bem como todos os símbolos de até 2.000 arquivos de usuário. - Quando não definido, o Visual Studio exibe símbolos referenciados ou usados em arquivos abertos ou carregados anteriormente pelo editor. |
Opções interativas do Windows
As seguintes opções estão disponíveis em Ferramentas>Opções>Python>Janelas Interativas:
| Opção | Padrão | Description |
|---|---|---|
| Scripts | n/a | Especifica uma pasta geral para scripts de inicialização a serem aplicados ao Windows Interativo para todos os ambientes. Para obter mais informações, consulte scripts de inicialização. Observação: esse recurso pode não funcionar na sua versão do Visual Studio. |
| Setas para cima/para baixo navegam no histórico | Por | Usa as teclas de direção para navegar pelo histórico na janela Interativa . Desmarque essa configuração para usar as teclas de direção para navegar na saída da janela Interativa. |
| Modo de conclusão | Avaliar apenas expressões sem chamadas de função | O processo de determinar os membros disponíveis em uma expressão na janela Interativa pode exigir a avaliação da expressão inacabada atual, o que pode resultar em efeitos colaterais ou funções sendo chamadas várias vezes. A configuraçã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, ele avalia a instrução a.b , mas não a a().b instrução.
Nunca avaliar expressões elimina todos os efeitos secundários, utilizando apenas o motor padrão do IntelliSense para sugestões.
Avaliar todas as expressões avalia a expressão completa para obter sugestões, independentemente dos efeitos colaterais. |
| Ocultar sugestões de análise estática | Desativado | Quando definido, exibe apenas sugestões obtidas avaliando a expressão. Se combinado com o valor do modo de conclusãonunca avaliar expressões, nenhuma conclusão útil será exibida na janela Interativa . |
Opções do editor de texto para Python
No Editor de Texto>Python, há opções para barras de rolagem, guias e formatação, juntamente com configurações gerais e avançadas:
Opções gerais do editor do Python
As seguintes opções estão disponíveis em Ferramentas>Opções>Editor de Texto>Python>Geral:
| Opção | Padrão | Description |
|---|---|---|
| Lista automática de membros | Por | Defina essa opção para listar automaticamente os membros para conclusão de instruções de código. |
| Ocultar membros avançados | Por | Quando a opção Auto listar membros estiver habilitada, defina essa opção para ocultar membros avançados das sugestões de conclusão. Membros avançados são membros que são usados com menos frequência do que outros. |
| Informações de parâmetro | Por | Quando definido, passar o mouse sobre parâmetros mostra informações detalhadas, como a definição do item e links para a documentação. |
| Habilitar espaço virtual | Por | Quando definido, insere espaços no final de cada linha de código. Selecione essa opção para posicionar os comentários em um ponto consistente ao lado do código. O modo Espaço Virtual está habilitado no modo Seleção de Coluna . Quando o modo Espaço Virtual não está habilitado, o ponto de inserção passa do final de uma linha diretamente para o primeiro caractere da próxima linha. Observação: esta opção é influenciada pela configuração global habilitar o espaço virtual em Editor de Texto>Todos os Idiomas>Geral. Se a configuração global não estiver habilitada, essa opção não poderá ser habilitada no nível do idioma. |
| Quebra automática do Word | Desativado | Defina esta opção para permitir que as linhas longas de código quebrem com base na largura da janela do editor. |
| Mostrar glifos visuais para quebra automática de palavras | Desativado | Quando a opção de encapsulamento do Word estiver habilitada, defina essa opção para mostrar glifos visuais. |
| Números de Linha | Desativado | Defina essa opção para mostrar números de linha na margem esquerda do editor para cada linha de código. |
| Habilitar navegação de URL de clique único | Por | Quando definido, você pode clicar em uma URL para navegar até o local de destino. |
| Barra de navegação | Desativado | Defina essa opção para habilitar as caixas suspensas na parte superior da janela de código. Esses campos ajudam você a navegar até o código em uma base de código na qual você pode escolher um tipo ou membro para ir diretamente. Observação: essa opção é influenciada pela configuração global do Editor de Texto>Todos os Idiomas> Geral>Habilitar barra de navegação. Para obter mais informações, consulte Navegação na barra de código>. |
| Conclusão automática de chaves | Por | Quando definido, o Visual Studio adiciona automaticamente a chave de fechamento para qualquer chave aberta à medida que você insere o código. |
| Recortar ou Copiar aplicam-se a linhas vazias quando não há seleção | Por | Por padrão, o Visual Studio corta ou copia toda a linha de código quando não há seleção explícita. Use essa opção para habilitar ou desabilitar esse comportamento de Recortar ou Copiar quando invocado em linhas em branco. |
Para obter mais informações, consulte a caixa de diálogo Opções: Editor > Geral de Texto.
Opções avançadas do editor do Python
As seguintes opções estão disponíveis em Ferramentas>Opções>Editor de Texto>Python>Avançado:
| Opção | Padrão | Description |
|---|---|---|
| Oferecer conclusões de importação automática | Por | Quando definido, o Visual Studio oferece importações automáticas em conclusões. |
| Adicionar colchetes automaticamente para funções | Desativado | Quando definido, o Visual Studio adiciona automaticamente colchetes para funções à medida que você insere código no editor. |
Opções de fontes e cores
Outras opções do Python estão disponíveis emFontes e Cores do > quando o grupo Editor de Texto é definido como Python:
Os nomes das opções do Python são todos prefixados com "Python" e são autoexplicativos. A fonte padrão para todos os temas de cores do Visual Studio é 10 pt Consolas normal (não negrito). As cores padrão variam de acordo com o tema. Normalmente, você altera uma fonte ou cor para facilitar a leitura de texto.