{"title":"Como instalar o Django no Windows","version":"3.1","locale":"pt-br","docname":"howto/windows","url":"/pt-br/3.1/howto/windows/","canonical":"https://djangodocs.dev/pt-br/3.1/howto/windows/","summary":"This document will guide you through installing Python 3.8 and Django on Windows. It also provides instructions for setting up a virtual environment, which makes it…","html":"<h1>Como instalar o Django no Windows<a class=\"heading-anchor\" href=\"#how-to-install-django-on-windows\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>This document will guide you through installing Python 3.8 and Django on\nWindows. It also provides instructions for setting up a virtual environment,\nwhich makes it easier to work on Python projects. This is meant as a beginner’s\nguide for users working on Django projects and does not reflect how Django\nshould be installed when developing patches for Django itself.</p>\n<p>The steps in this guide have been tested with Windows 10. In other\nversions, the steps would be similar. You will need to be familiar with using\nthe Windows command prompt.</p>\n<section id=\"install-python\">\n<span id=\"install-python-windows\"></span><h2>Instalando Python<a class=\"heading-anchor\" href=\"#install-python\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Django is a Python web framework, thus requiring Python to be installed on your\nmachine. At the time of writing, Python 3.8 is the latest version.</p>\n<p>To install Python on your machine go to <a class=\"reference external\" href=\"https://python.org/downloads/\">https://python.org/downloads/</a>. The\nwebsite should offer you a download button for the latest Python version.\nDownload the executable installer and run it. Check the boxes next to “Install\nlauncher for all users (recommended)” then click “Install Now”.</p>\n<p>Depois da instalação, abra a linha comando e verifique se a versão do Python é a mesma que a versão instalada executando:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py --version\n</code></pre></div>\n<aside class=\"admonition admonition-seealso\" role=\"note\">\n<p class=\"admonition-title\">Ver também</p>\n<p>For more details, see <a class=\"reference external\" href=\"https://docs.python.org/3/using/windows.html\" title=\"(em Python v3.14)\"><span>Using Python on Windows</span></a> documentation.</p>\n</aside>\n</section>\n<section id=\"about-pip\">\n<h2>Sobre o <code class=\"docutils literal notranslate\">pip</code><a class=\"heading-anchor\" href=\"#about-pip\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p><a class=\"reference external\" href=\"https://pypi.org/project/pip/\">pip</a> is a package manager for Python and is included by default with the\nPython installer. It helps to install and uninstall Python packages\n(such as Django!). For the rest of the installation, we’ll use <code class=\"docutils literal notranslate\">pip</code> to\ninstall Python packages from the command line.</p>\n</section>\n<section id=\"setting-up-a-virtual-environment\">\n<span id=\"virtualenvironment\"></span><h2>Setting up a virtual environment<a class=\"heading-anchor\" href=\"#setting-up-a-virtual-environment\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>It is best practice to provide a dedicated environment for each Django project\nyou create. There are many options to manage environments and packages within\nthe Python ecosystem, some of which are recommended in the <a class=\"reference external\" href=\"https://packaging.python.org/guides/tool-recommendations/\">Python\ndocumentation</a>.\nPython itself comes with <a class=\"reference external\" href=\"https://docs.python.org/3/tutorial/venv.html\" title=\"(em Python v3.14)\"><span class=\"xref std std-doc\">venv</span></a> for managing\nenvironments which we will use for this guide.</p>\n<p>To create a virtual environment for your project, open a new command prompt,\nnavigate to the folder where you want to create your project and then enter the\nfollowing:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m venv project-name\n</code></pre></div>\n<p>This will create a folder called ‘project-name’ if it does not already exist\nand setup the virtual environment. To activate the environment, run:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> project-name\\Scripts\\activate.bat\n</code></pre></div>\n<p>The virtual environment will be activated and you’ll see “(project-name)” next\nto the command prompt to designate that. Each time you start a new command\nprompt, you’ll need to activate the environment again.</p>\n</section>\n<section id=\"install-django\">\n<h2>Instalando Django<a class=\"heading-anchor\" href=\"#install-django\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>O Django pode ser facilmente instalado dentro de seu ambiente virtual usando o <code class=\"docutils literal notranslate\">pip</code>.</p>\n<p>Na linha de comando, assegure-se que seu ambiente virtual esteja ativo, e execute o seguinte comando:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> py -m pip install Django\n</code></pre></div>\n<p>Isso irá baixar e instalar a última versão do Django.</p>\n<p>Depois que a instalação for concluída, você pode verificar sua instalação do Django executando <code class=\"docutils literal notranslate\">django-admin --version</code> na linha de comando.</p>\n<p>Veja <a class=\"reference internal\" href=\"/pt-br/3.1/topics/install/#database-installation\"><span class=\"std std-ref\">Tenha seu banco de dados rodando</span></a> para informações sobre a instalação do banco de dados com Django.</p>\n</section>\n<section id=\"common-pitfalls\">\n<h2>Armadilhas comuns<a class=\"heading-anchor\" href=\"#common-pitfalls\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<ul>\n<li><p>Se o  <code class=\"docutils literal notranslate\">django-admin</code> somente mostra o texto de ajuda não importando quais argumentos lhe é dado, provavelmente tem um problema com a associação do arquivo no windows. Verifique se existe mais de uma variável de ambiente definida para rodar os scripts Python no <code class=\"docutils literal notranslate\">PATH</code>. Isso normalmente ocorre quando existe mais de uma versão de Python instalada.</p></li>\n<li><p>If you are connecting to the internet behind a proxy, there might be problems\nin running the command <code class=\"docutils literal notranslate\">py -m pip install Django</code>. Set the environment\nvariables for proxy configuration in the command prompt as follows:</p>\n<div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Windows code\"><code><span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">http_proxy</span><span class=\"p\">=</span>http://username:password@proxyserver:proxyport\n<span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">https_proxy</span><span class=\"p\">=</span>https://username:password@proxyserver:proxyport\n</code></pre></div>\n</li>\n</ul>\n</section>","rootId":"how-to-install-django-on-windows","toc":[{"title":"Instalando Python","anchor":"install-python","children":[]},{"title":"Sobre o pip","anchor":"about-pip","children":[]},{"title":"Setting up a virtual environment","anchor":"setting-up-a-virtual-environment","children":[]},{"title":"Instalando Django","anchor":"install-django","children":[]},{"title":"Armadilhas comuns","anchor":"common-pitfalls","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Guias de “como fazer”","url":"/pt-br/3.1/howto/"}],"prev":{"docname":"howto/static-files/deployment","title":"Deploy de arquivos estáticos","url":"/pt-br/3.1/howto/static-files/deployment/"},"next":{"docname":"howto/writing-migrations","title":"Escrevendo migrações de banco de dados","url":"/pt-br/3.1/howto/writing-migrations/"},"formats":{"html":"/pt-br/3.1/howto/windows/","markdown":"/pt-br/3.1/howto/windows.md","json":"/pt-br/3.1/howto/windows.json"},"source":"https://github.com/django/django/blob/stable/3.1.x/docs/howto/windows.txt","official":"https://docs.djangoproject.com/pt-br/3.1/howto/windows/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}