更新时间:2025-08-19 GMT+08:00
分享

运行Django应用

该启动配置执行“python manage.py runserver”命令来启动内置的Django开发服务器。

图1 运行Django应用
表1 启动配置属性

名称

描述

“type”

调试器的类型。对于运行和调试Python代码,应将其设置为“python”

“name”

启动配置的名称。

“addSourceRootsToPythonpath”

如果设置为true,项目的源代码根文件夹将被添加到PYTHONPATH环境变量中,从而扩展模块文件的默认搜索路径。有关使用项目源根目录的详细信息,请参阅配置项目结构

“request”

调试模式,可以是“launch”(在program中指定的文件或当前文件上启动调试器)、“attach”(将调试器附加到已经运行的进程)或“test”(运行单元测试)。对于Python文件启动配置,此选项始终设置为“launch”

“jinja”

当设置为“true”(默认)时,启用对Jinja模板的调试,例如在Flask应用程序中。

“python”

Python可执行文件的路径。默认值“${command:python.interpreterPath}”解析为当前选定的项目解释器。有关在项目中使用Python解释器的详细信息,请参阅“Python环境”。

“stopOnEntry”

当设置为“true”时,程序将在启动时自动挂起。

“program”

管理 `manage.py` 的路径,这是 Django 的命令行管理工具。默认情况下,该路径设置为 `${workspaceFolder}\\manage.py`,以定位项目根目录下的 `manage.py`。您可以使用变量来提供路径。

“env”

一组定义为键值对的环境变量。属性键为环境变量,属性值为环境变量的值。

“envFile”

环境变量定义文件的路径。默认情况下,此路径设置为${workspaceFolder}/.env指向.env项目根目录下的文件。

“logToFile”

当设置为“true”时,调试器事件将记录到文件中。默认情况下,此选项设置为“false”。默认的日志目录是“%userprofile%\.codearts\extensions\codearts.python-<version>\javaFiles\<project-name>\dap_<date>”

“args”

传递给manage.py的命令行参数。默认情况下,设置为runserver,它将启动内置的 Django 开发服务器。

“cwd”

调试程序工作目录的绝对路径。默认值${workspaceFolder}解析为包含调试文件的文件夹。您可以使用变量来提供路径。

“subProcess”

指定是否启用子进程调试。由于 Django 严重依赖子进程,因此该选项始终设置为true。

“justMyCode”

如果设置为 “true”(默认),则仅显示和调试用户编写的代码。否则,显示和调试所有代码,包括库调用。

“django”

在此节点下,提供了Django开发服务器的参数设置。

- host/port:指定运行Django服务器的主机和端口。

- runBrowser:若设置为true,将在默认浏览器中打开runBrowserUri下提供的URI。

- commandLineOptions:为manage.py工具提供的命令行选项。

- testServer:若设置为true,将使用fixtures下提供的固定数据集,以测试数据库启动Django开发服务器。(更多关于测试服务器使用的详情,请参阅Django文档)。

- noReload:若设置为true,当服务器运行时,对Python代码的任何更改若相关模块已加载至内存中,则不会生效(此选项在testServer设置为false时可用)。

- runBrowserUri:在默认浏览器中打开的应用页面URI(此选项在runBrowser设置为true时可用)。

- fixtures:提供给测试数据库的数据固定数据集列表。

“pythonArgs”

传递给Python解释器的命令行参数。要将参数传递给被调试程序,请使用“args”

“showReturnValue”

如果设置为“true”(默认),则在“运行和调试”视图中逐步执行时显示函数的返回值。

启动配置示例

以下是一个可运行的启动配置示例。

{
    "addSourceRootsToPythonpath": true,
    "request": "launch",
    "jinja": true,
    "python": "${command:python.interpreterPath}",
    "envFile": "${workspaceFolder}/.env",
    "stopOnEntry": false,
    "program": "${workspaceFolder}/manage.py",
    "env": {},
    "type": "python",
    "logToFile": false,
    "cwd": "${workspaceFolder}",
    "subProcess": true,
    "justMyCode": true,
    "django": {
        "port": 8000,
        "host": "127.0.0.1",
        "runBrowser": true,
        "commandLineOptions": [],
        "testServer": false,
        "noReload": false,
        "runBrowserUri": "http://127.0.0.1:8000/",
        "fixtures": []
    },
    "pythonArgs": [],
    "name": "Python: Django Server",
    "showReturnValue": true
}

相关文档