服务器测评网
我们一直在努力

Linux下Django安装总报错?新手必看避坑指南!

环境准备与系统更新

在Linux系统中安装Django前,需确保系统环境已准备就绪,以Ubuntu/Debian为例,首先更新系统包列表并升级已安装的软件包,这一步能确保后续依赖库的兼容性,打开终端,执行以下命令:

Linux下Django安装总报错?新手必看避坑指南!

sudo apt update && sudo apt upgrade -y

对于CentOS/RHEL系统,可使用:

sudo yum update -y

确保系统已安装Python和pip,Django基于Python开发,两者是必要前提,检查Python版本(建议3.6+)和pip是否安装:

python3 --version  
pip3 --version

若未安装pip,可通过包管理器添加,如Ubuntu系统执行:

sudo apt install python3-pip -y

创建虚拟环境(推荐实践)

为避免项目依赖冲突,建议使用Python虚拟环境隔离项目依赖,安装venv模块(Ubuntu/Debian需手动安装):

sudo apt install python3-venv -y

在项目目录下创建虚拟环境(例如命名为venv):

mkdir django_project && cd django_project  
python3 -m venv venv

激活虚拟环境:

  • Bash/Zshsource venv/bin/activate
  • Fishsource venv/bin/activate.fish
    激活后,终端提示符会显示(venv),表示已进入虚拟环境,后续所有Python包安装将在此环境中隔离进行。

安装Django框架

虚拟环境激活后,使用pip安装Django,推荐指定稳定版本(如5.0 LTS),避免使用最新版可能存在的兼容性问题:

Linux下Django安装总报错?新手必看避坑指南!

pip install django==5.0.0

安装完成后,验证Django是否成功:

django-admin --version

若输出版本号(如0.0),则表示安装成功,若提示命令未找到,可检查pip是否指向虚拟环境中的Python路径(venv/bin/pip)。

创建第一个Django项目

安装完成后,使用Django命令行工具创建项目,例如创建名为myproject的项目:

django-admin startproject myproject

该命令会生成一个myproject目录,包含以下核心文件:

  • manage.py:项目管理脚本,用于运行开发服务器、数据库迁移等操作。
  • myproject/:项目配置目录,包含settings.py(项目设置)、urls.py(URL路由)、wsgi.py(WSGI接口)等。

配置与运行开发服务器

进入项目目录并启动开发服务器:

cd myproject  
python manage.py runserver

默认情况下,服务器运行在http://127.0.0.1:8000/,若需监听所有网络接口(如局域网访问),可指定地址:

python manage.py runserver 0.0.0.0:8000

在浏览器中访问该地址,若看到Django欢迎页面,则项目创建成功,开发服务器仅用于调试,生产环境需搭配Gunicorn、uWSGI等WSGI服务器和Nginx反向代理使用。

Linux下Django安装总报错?新手必看避坑指南!

数据库配置与迁移

Django默认使用SQLite数据库,无需额外配置,若需使用MySQL或PostgreSQL,需安装相应数据库驱动(如mysqlclientpsycopg2-binary)并修改settings.py中的DATABASES配置。
初始化数据库并应用迁移:

python manage.py makemigrations  
python manage.py migrate

创建超级用户以访问Django管理后台:

python manage.py createsuperuser

按提示输入用户名、邮箱和密码后,访问http://127.0.0.1:8000/admin/即可登录管理后台。

部署注意事项

开发完成后,若需部署到生产环境,需注意以下几点:

  1. 静态文件处理:运行python manage.py collectstatic收集静态文件(CSS、JS等),并配置Web服务器(如Nginx)提供服务。
  2. 环境变量:将敏感信息(如密钥、数据库密码)存储在环境变量中,避免硬编码在settings.py中。
  3. 性能优化:使用缓存(如Redis)、数据库索引、CDN加速等手段提升性能。

通过以上步骤,即可在Linux系统中完成Django的安装与项目搭建,遵循虚拟环境隔离、版本控制、安全配置等最佳实践,能为后续开发与维护奠定良好基础。

赞(0)
未经允许不得转载:好主机测评网 » Linux下Django安装总报错?新手必看避坑指南!