Visual Studio Code 及组件安装

如果你希望在本课程中开发应用程序，或在本地机器上练习 Django Web 开发，我们推荐使用 Visual Studio Code 作为集成开发环境（IDE）。在本节课中，我们将介绍在安装好 Visual Studio Code 后如何设置你的开发环境。

创建项目文件夹

首先创建一个用于存放所有项目文件的文件夹。我将该文件夹命名为 EXAMPLE。打开 Visual Studio Code，通过点击 文件 → 打开 来打开这个文件夹。在此文件夹内再创建一个名为 project 的子文件夹，我将其命名为 project。

通过点击 终端 → 新建终端 打开终端窗口。在命令行路径中确认当前位于你创建的第一个文件夹（EXAMPLE）内。确认后，使用 cd 命令进入你的项目文件夹（project），如下所示。

虚拟环境

虚拟环境（venv）有助于将各个项目相对独立地隔离，避免在计算机上全局安装 Python 包，从而减少不同包之间可能产生的冲突问题。

我们需要创建并激活一个虚拟环境。执行以下命令：

执行这些命令后，请检查你的文件夹结构是否与下图一致。

确认虚拟环境（venv）已成功创建后，开始安装项目所需的包。有多种方式安装包，我们将使用 pip install 命令。

安装包

Pip 是 Python 的标准包管理工具，可通过命令行界面安装和管理包。

在终端中执行以下命令：

1pip install Django
2pip install Pillow
3pip install psycopg2
4pip install psycopg2-binary

Django

Django 是一个用于快速、安全地开发 Web 应用程序的 Python 框架。它是免费且开源的，支持快速原型设计，同时保持安全可靠的架构。它也适用于可扩展性要求较高的项目。

Pillow

Pillow 是一个 Python 库，用于处理图像文件，支持图像的编辑、上传和保存。该库为网站提供了基本的图像处理功能，使其能够处理各种图像格式。

Psycopg2 与 Psycopg2-binary

这两个库用于连接 PostgreSQL 数据库。psycopg2-binary 适合开发和测试阶段使用。如果你不打算将项目部署到 Heroku，仅安装此库即可。

如果你使用的是 SQLite3 数据库，则无需安装这两个包。

Psycopg2 安装错误

如果执行 pip install psycopg2 后出现类似以下错误，请按以下步骤进行排查：

执行 pg_config 命令，复制 LDFLAGS 后面的路径（即等号后的全部内容），然后将其粘贴到如下命令中的引号内：

命令总结

代码检查器（Linter）配置

代码检查器用于检测代码中的潜在问题，例如语法错误、结构问题和不符合最佳实践的情况。如果你不介意代码下方出现红色波浪线，可以跳过此配置。但代码检查器对学习编程语言非常有帮助。

尝试打开项目目录下的 urls.py 文件，在屏幕底部查看是否有问题提示。如果某个问题显示为 pylint(import-error)，请按以下步骤解决。

1. 进入 视图 > 命令面板 > Python: 选择 Linter > pylint。确保 启用检查 选项已开启。VS Code 默认为 Python 代码启用 pylint。

2. 选择 pylint 后，左侧会出现一个 .vscode 文件夹。

3. 打开 .vscode 文件夹中的 settings.json 文件，并进行如下修改：

settings.json 文件内容如下：

1{
2    "python.linting.pylintEnabled": true,
3    "python.linting.enabled": true
4}

注意： 你的 settings.json 文件内容可能有所不同。

更新后的 settings.json 内容如下：

1{
2    "team.showWelcomeMessage": false,
3    "editor.formatOnSave": true,
4    "python.linting.pycodestyleEnabled": true,
5    "python.linting.pylintArgs": [
6        "--load-plugins",
7        "pylint_django"
8    ],
9    "python.pythonPath": "/usr/bin/python3",  // 此路径可能因系统而异
10    "python.linting.pylintEnabled": true,
11    "python.linting.enabled": true
12}

1. 保存 settings.json 文件后，代码下方的红色波浪线应消失。

注意： 如果保存后仍提示“行过长（91 > 79 字符）”，你可以忽略该警告，或手动将过长的行拆分为两行。这是由于 Python 编码规范建议每行不超过 79 个字符。无论是否修复，代码均可正常运行。