统信uos搭建django开发环境需先验证并安装python3、pip3、venv,再创建软链接统一命令入口,接着在虚拟环境中安装django 4.2.15,最后初始化项目并配置allowed_hosts。

在统信UOS系统中搭建Django开发环境,需先确保Python基础运行时与pip包管理器可用,再安装Django及其依赖组件,最后完成项目级初始化与基础配置;若直接执行django-admin命令报错“command not found”,说明环境链路尚未打通。
验证并补全Python开发环境
统信UOS桌面版预装Python 3.9+但常缺失pip、venv及编译头文件,这会导致后续Django安装失败或无法编译C扩展(如psycopg2)。必须先确认并补齐这些组件。
打开终端,依次执行以下命令:
python3 --version → 若无输出或报错,说明Python未安装,需先执行sudo apt install python3;若有版本号(如Python 3.10.12),继续下一步。
pip3 --version → 若提示“command not found”,则必须安装pip3:sudo apt install python3-pip。
python3 -m venv --help → 若报错“no module named venv”,说明缺少venv支持,执行sudo apt install python3-venv。
【关键前提】必须同时满足python3、pip3、venv三者可用,否则后续创建虚拟环境会失败。
安装Django并设置默认Python命令
为避免脚本调用python或pip时出错,建议统一命令入口。Django官方工具(如django-admin)依赖系统级python和pip可执行路径,不推荐仅靠别名临时生效。
方法一:创建系统级软链接(推荐,适用于有sudo权限用户)
执行sudo ln -sf /usr/bin/python3 /usr/bin/python。
执行sudo ln -sf /usr/bin/pip3 /usr/bin/pip。
验证:python --version && pip --version → 两者均应输出匹配版本信息。
方法二:用户级别名(无sudo权限时使用)
执行echo "alias python=python3" >> ~/.bashrc && echo "alias pip=pip3" >> ~/.bashrc。
执行source ~/.bashrc使配置立即生效。
安装Django:pip install django==4.2.15(指定LTS稳定版,避免新版本兼容性问题)。
创建Django项目并初始化配置
这一步必须在独立虚拟环境中进行,防止全局pip污染和版本冲突。UOS桌面环境对全局site-packages敏感,一旦误装不兼容包可能导致系统应用异常。
第一步:新建项目目录并进入
mkdir ~/mydjango && cd ~/mydjango。
第二步:创建并激活虚拟环境
python -m venv venv → 自动生成venv子目录,含隔离的Python解释器与pip。
source venv/bin/activate → 终端提示符前出现(venv)即表示激活成功。
第三步:升级pip并安装Django
pip install --upgrade pip → 避免旧版pip无法解析某些wheel包。
pip install django==4.2.15 → 明确指定版本号,防止自动升级到不兼容的5.x系列。
第四步:生成新项目骨架
django-admin startproject mysite . → 注意末尾的英文句点,表示将项目文件生成在当前目录而非子目录,便于后续nginx/uwsgi部署时路径对齐。
第五步:修改settings.py基础配置
用文本编辑器打开mysite/settings.py,定位到ALLOWED_HOSTS行,改为ALLOWED_HOSTS = ['localhost', '127.0.0.1'];若需外网访问,须填入实际IP或域名,【严禁设为['*']用于生产环境】。











