用vscode创建django项目和配置环境的流程

之前用pycharm创建django项目实现了，网上搜了一下，好像用vscode也挺好用的，插件也比较丰富，而且vscode也是免费的，就试着用vscode来搭建一下django，想用在宝塔面板上跑，而宝塔面板支持的python版本最高为3.10.0，这次就换这个版本的python了，顺便记录一下流程，防止忘记了。

1、下载vscode编辑器和python 3.10.0到本地安装，具体百度可以搜到。

2、点击vscode左侧【扩展】图标，搜索并安装一系列必要的插件，包括：

（1）中文语言包

Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code

（2）python及django插件

Python（微软官方的）

Pylance（微软官方的）

Django（有好几个同名插件，选人气高的就行了，基本上都是优化代码和提示，后端模板支持啥的）

Django Template（模板语言支持）

都是对相关语言和环境支持的扩展插件，另外也可以自己搜一些其他相关的插件安装，不过基本上都是英文，懒得装了。

3、在电脑上建一个文件夹作为目录，比如我这里建了一个名为vs的文件夹，点击顶部菜单【文件】>【打开文件夹】，就可以在左侧第一个图标【资源管理器】里看到自己的目录了，左侧一般就停留在【资源管理器】的界面。

4、在顶部【终端】菜单，选择【新建终端】，或者在资源管理器文件夹列表的空白处鼠标右键点击，选择【在集成终端中打开】进入目录终端，在终端中输入指令创建django项目和env虚拟环境。

虚拟环境目录创建指令：

python -m venv env

django项目创建指令，比如项目名为mysite：

django-admin startproject mysite

创建完之后，资源管理器的vs目录下，会多出一个env和mysite文件夹目录。

也可以先完成mysite目录的创建，再右键选择【在集成终端中打开】打开mysite目录的终端，创建env虚拟环境到mysite项目下面，我看网上env目录位置放项目里和项目外的都有，感觉区别不是很大，可能就是配置python解释器时的目录位置不一样吧，另外可以资源管理器直接打开mysite文件夹，后续的终端操作都是自动在mysite文件夹下，不会有时候点错到vs文件夹。

5、在顶部菜单【查看】中，选择【命令面板】，配置解释器，在弹出的输入框中输入python字样，点击列表中出现的【python：选择解释器】，在新弹出的列表中选择带有括号env的那个点击一下（必须配置虚拟环境，不然运行不起来）。

解释器配置完，再删除关闭终端，重新打开项目终端进入，就会发现默认的指令输入行最前面多了个带括号的env字样，这就是虚拟环境配置ok了。

6、在项目终端中，输入python manage.py runserver试试能不能运行，如果提示中有提到no module named ‘django‘字样，大概就是新配置的虚拟环境中没有django模块框架，可以重新在终端重新安装一下django：

pip install django

如果出现提示pip版本太低的英文警告，也可以按照提示中的指令升级一下pip版本：

python -m pip install --upgrade pip

查看当前的django版本用这个指令：

pip show django

7、输入指令，运行django项目试试：

python manage.py runserver

出现提示 http://127.0.0.1:8000/ 字样，就代表可以访问了。

如果细看一下，项目运行成功的提示中可能会有这么一段报错的警告，如：You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.

虽然访问http://127.0.0.1:8000/好像没啥问题，但是在使用python manage.py createsuperuser指令创建后台账号密码时，会依然报错一大堆代码，也包含上面这个警告，可能就是项目没有数据库啥的，这个时候需要做的是，初始化数据库表结构：

python manage.py makemigrations
python manage.py migrate

完成之后，就没有这个报错了，如果不行就只试试migrate指令。

migrate和makemigrations指令，似乎经常一起使用，两者都是用来处理数据库架构的，官方是这么描述的：

migrate，负责应用和撤销迁移。
makemigrations，基于模型的修改创建迁移。

makemigrations 负责将模型修改打包进独立的迁移文件中——类似提交修改，而 migrate 负责将其应用至数据库。

8、在终端中创建后台账号密码：

python manage.py createsuperuser

其中，在输入密码的时候，是不会显示出来的，输完直接回车确认就可以了，创建完账号密码，访问 http://127.0.0.1:8000/admin/ 就会出现登录界面，可以进入后台了。

9、另外也可以用vscode的调试工具进行项目调试，左侧图标列表，有一个左下角有个虫子的三角形图标，就是管理调试工具的。

点击窗口汇总的 创建 launch.json 文件 字样，可以在项目目录创建一个.vscode的文件夹，可以修改 launch.json 中的路径参数，防止调试的项目文件夹跟实际不一致。

好像不搞这个调试工具，在终端里用指令一样能跑起来。

10、在settings.py中修改语言和时区，将默认参数改成这样：

LANGUAGE_CODE = 'zh-hans' #中文语言
TIME_ZONE = 'Asia/Shanghai' #时区

11、创建app，输入指令：

python manage.py startapp myapp #这个myapp就是你要创建的app的名字和目录名

创建的app目录文件夹应该跟 manage.py同级，如果不在同一层目录里，可能就是哪里设置错了，多改改研究一下就行了。

将创建的app在settings.py中加上，具体位置在：

INSTALLED_APPS = [
    'django.contrib.admin',
    ...
    'myapp',  # app名称
]

后面就是去app的models.py中创建模型啥的，就不写了，具体可以百度搜索。

总结一下，使用vscode跟pycharm差别不大，具体也就是pycharm是专门针对python的，而vscode用途更多吧，对于新手来说，使用python或django来创建项目，配置环境都挺麻烦的，主要是还基本上都是英文描述和提示，不过环境配置好后就ok了。另外，后台美化，指令跟pycharm都是一样的，就不写了。

代码007普通

打赏 收藏 海报 链接