在 Visual Studio Code (vscode) 中设置 Python 工作区 wemake-python-styleguide

2025-06-07

在 Visual Studio Code (vscode) 中设置 Python 工作区

wemake-python-样式指南

作为一名程序员,每当我们启动一个新项目(无论使用哪种语言),都需要为项目设置一个运行环境。该环境可能包含编辑器、支持项目的软件包、特定语言的 Linter 和格式化程序等。稳定的环境可以帮助您专注于实现的主要方面,而将其他所有事情留给设置来处理。让我们开始在 vscode 中设置 Python 环境。

在我们开始之前,请注意,我选择 vscode 是因为我习惯使用它,你可能有不同的选择。只要它能帮助你享受编程体验,那就完全没问题。

任何语言的环境设置都可以规定为以下几点:

  1. 安装特定语言的编译器/解释器
  2. 安装包管理器
  3. 设置虚拟环境
  4. 设置代码编辑器

1. 安装特定语言的编译器/解释器

对于 Python,你必须安装一个特定于 Python 操作系统的解释器才能执行你的代码。只需访问此链接并在你的机器上安装相应版本的 Python 即可。此外,请通过以下命令确保已在系统上正确安装 Python:



$ python --version
Python 3.7.2


Enter fullscreen mode Exit fullscreen mode

2. 安装包管理器

pip是一个非常流行的 Python 软件包安装程序。它可以帮助您管理 Python 软件包。您可以访问此链接进行安装pip。同样,只需验证您的系统是否已安装它即可。



$ pip --version
pip 20.0.2


Enter fullscreen mode Exit fullscreen mode

3. 设置虚拟环境

Python 应用程序经常会使用标准库中未包含的包和模块(即上述步骤中提到的)。应用程序有时需要特定版本的库。这意味着可能有多个应用程序运行所需的 Python 和/或模块版本不同。所有应用程序都使用一个全局版本并不能满足需求。

解决这个问题的方法是创建一个虚拟环境,这是一个独立的目录树,其中包含特定版本的 Python 安装以及许多附加包。

有许多 python 包可供您创建虚拟环境 python,例如virtualenvpyenv等。我将virtualenv在本文中使用这些包。



# installing virtual environment
$ pip install virtualenv
$ virtualenv --version
virtualenv 20.0.8


Enter fullscreen mode Exit fullscreen mode

到目前为止,我们一直在全局安装所有内容。从现在开始,我们将创建一个虚拟环境,将安装限制在该特定环境(文件夹)内。



# creating a project folder
$ mkdir python-demo
# creating a virtual environment for this project
$ virtualenv python-demo
# this will create a virtual environment folder <python-demo> in the current folder


Enter fullscreen mode Exit fullscreen mode

创建虚拟环境后,我们需要确保在该项目内部安装了该项目所需的所有其他 Python 包。具体操作如下:使用以下命令激活虚拟环境:



# for ubuntu
$ source <virtual-env-folder-path>/bin/activate
$ source python-demo/bin/activate

# for windows
$ <virtual-env-folder-path>\Scripts\activate
$ python-demo\Scripts\activate

# After this, your command prompt/terminal will change the path with the virtual environment name
(python-demo) $

# to deactivate the virtual environment, just type the command deactivate
(python-demo) $ deactivate
$


Enter fullscreen mode Exit fullscreen mode

4. 设置代码编辑器

现在,让我们在 vscode 代码编辑器中设置 Python 环境。每当您在代码编辑器中编写代码时,它通常需要执行两项任务:代码检查和代码格式化。VScode 支持多种代码检查器和格式化程序,以帮助您完善工作区。

在为 Python 环境创建工作区设置之前,我们先安装一个 Linter 和一个 Python 格式化程序。我将使用autopep8pylint来实现相同的功能。您也可以选择任何其他 Python 软件包,只需点击此链接即可。



# Make sure you have activated your virtual environment
(python-demo) $ pip install autopep8 pylint


Enter fullscreen mode Exit fullscreen mode

我已经settings.json在 vscode 中创建了 python 环境。

{
"python.pipenvPath": "<your-env-path>", // if using pipenv
"editor.formatOnPaste": true,
"editor.formatOnSave": true,
"autopep8.path": ["<your-env-path>/bin/autopep8"],
"autopep8.args": [
"--max-line-length",
"70",
"--aggressive",
],
"autopep8.importStrategy": "fromEnvironment",
// if using pylint
"pylint.path": "<your-env-path>/bin/pylint",
"pylint.args": [
"--load-plugins",
"pylint_django", // only if you are using django framework
"--enable=W0614",
"--enable= W0611"
],
"pylint.importStrategy": "fromEnvironment",
// if using flake8 (uncomment below lines and comment above block of settings of pylint
// "flake8.path": ["<your-env-path>/bin/flake8"],
// "flake8.args": [
// "--max-line-length=130"
// ],
// "flake8.importStrategy": "fromEnvironment",
// to enable sort imports on save
"editor.codeActionsOnSave": {
"source.organizeImports": true
},
// to add environment vars while opening a new vscode terminal (name:val)
"terminal.integrated.env.linux": {
"DJANGO_ENV": "DEV"
},
"[python]": {
"editor.tabSize": 4
},
}

按照此 gif 更新你的 vscode 编辑器settings.json

Python 工作区助手 gif

不要忘记用以下方式替换虚拟环境路径<your-env-path>

最后,安装此 vscode python 扩展以在 vscode 中启用 python 支持。

vscode-python-扩展

奖金🔥

您还可以通过以下链接在 vscode 工作区中添加调试器配置。


如果您觉得这篇文章有用或有任何建议,请随时发表评论。另外,如果您喜欢我的文章,别忘了点赞❤️或🦄。

下次再见!

文章来源:https://dev.to/idrisrampurawala/setting-up-python-workspace-in-visual-studio-code-vscode-149p
PREV
🚀 使用 Node.js React.js 构建和生成发票 PDF 基于 Node.js 的开源 ERP CRM React.js 基于 Node.js 的开源 ERP CRM React.js
NEXT
如何成为 10x 开发者