必须按顺序安装python3、python3-pip、python3-venv、python3-dev及build-essential等依赖,并配置清华镜像源与python/pip别名,否则Python项目无法构建调试。

在统信UOS系统中运行Python脚本提示“command not found: python”、pip安装包超时失败、或执行pyinstaller报错“no module named setuptools”,说明系统虽可能预装Python解释器,但缺少pip、venv、编译头文件及国内镜像源等关键开发组件。必须按顺序补全这四类要素,否则后续任何Python项目都无法正常构建与调试。
确认系统是否已预装Python3及基础状态
打开终端(Ctrl+Alt+T),依次执行以下命令:
输入 python3 --version 查看是否返回类似 Python 3.10.12 的有效输出;若提示“command not found”,说明未预装或PATH异常。
运行 which python3 确认可执行文件路径是否为 /usr/bin/python3;如果不是,需检查PATH环境变量或重装python3包。
立即学习“Python免费学习笔记(深入)”;
执行 pip3 --version 验证pip3是否存在;【若提示“command not found”,则不能跳过下一步安装】,因为系统预装Python3时通常不附带pip3。
用apt安装Python核心工具与完整开发依赖
这一步必须执行,不可省略——仅靠预装Python3无法编译C扩展、创建虚拟环境或安装多数第三方包。
更新软件索引:sudo apt update
安装解释器、包管理器、虚拟环境支持及C扩展编译所需头文件:sudo apt install python3 python3-pip python3-venv python3-dev
安装基础编译工具链:sudo apt install build-essential
安装HTTPS、动态链接和压缩功能依赖:sudo apt install libssl-dev libffi-dev zlib1g-dev。缺少其中任一库,后续安装requests、cryptography、Pillow等常见包时会直接编译失败。
配置python与pip命令别名(适配传统脚本)
方法一:系统级软链接(推荐,全局生效)
第一步:创建python指向python3的符号链接:sudo ln -sf /usr/bin/python3 /usr/bin/python
第二步:创建pip指向pip3的符号链接:sudo ln -sf /usr/bin/pip3 /usr/bin/pip
第三步:验证是否生效:python --version && pip --version 应同时输出匹配版本号;若提示权限拒绝,请改用方法二。
方法二:用户级别名(无需root权限)
执行 echo "alias python=python3" >> ~/.bashrc && echo "alias pip=pip3" >> ~/.bashrc && source ~/.bashrc。该方式仅对当前用户终端生效,重启终端后自动加载。
配置清华pip镜像源加速包安装
默认PyPI源在国内访问极慢,不配置会导致pip install频繁超时、中断甚至误判为包不存在。
创建pip配置目录:mkdir -p ~/.pip
用nano编辑配置文件:nano ~/.pip/pip.conf
写入以下三行内容(注意缩进与换行):
[global]index-url = https://pypi.tuna.tsinghua.edu.cn/simple/trusted-host = pypi.tuna.tsinghua.edu.cn
保存退出后,执行 pip config list 确认配置已加载;此后所有pip install命令将自动走清华源。
验证开发环境是否可用
创建测试目录并进入:mkdir ~/pytest && cd ~/pytest
用系统Python3创建虚拟环境:python3 -m venv venv
激活虚拟环境:source venv/bin/activate
升级pip到最新版:pip install --upgrade pip
安装一个带C扩展的典型包:pip install requests。若成功下载并编译完成,说明Python解释器、pip、编译工具链、头文件与镜像源全部就绪。


















