活动公告

系统通知
通知：2026夏日主题满意度调查
06-22 18:10
系统通知
通知：微软邮箱更换提醒
06-14 00:00
系统通知
通知：本站资源由网友上传分享，如有违规等问题请到版务模块进行投诉，资源失效请在帖子内回复要求补档，会尽快处理！
10-23 09:31
>社区 > 科技 > 经验交流 >帖子
本版发帖返回

Ubuntu MATE系统下Python安装完全指南 从基础下载到环境配置再到常见问题解决新手也能轻松掌握的详细教程

这是个蓝孩子 当前离线 威震华夏关云长
SunJu_FaceMall

3万

主题

3142

科技点

3万

积分

执行版主

碾压王

积分
32876

塔罗立华奏
执行版主 发表于 2025-9-9 10:10:00 | 显示全部楼层 |阅读模式

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

您需要 登录 才可以下载或查看，没有账号？立即注册

x
引言

Python是一种高级、通用型、解释型的编程语言，以其简洁的语法和强大的功能而广受欢迎。无论是在数据科学、人工智能、Web开发还是自动化脚本领域，Python都扮演着重要角色。Ubuntu MATE作为Ubuntu的一个官方衍生版，以其友好的用户界面和适中的系统资源占用而受到许多开发者的喜爱。

在Ubuntu MATE系统上正确安装和配置Python环境是开始Python编程之旅的第一步。本指南将详细介绍如何在Ubuntu MATE系统上安装Python，配置开发环境，以及解决常见问题，帮助新手轻松掌握整个过程。

准备工作

系统要求

在开始安装Python之前，确保你的Ubuntu MATE系统满足以下基本要求：

• Ubuntu MATE 20.04 LTS或更高版本（推荐使用LTS版本以获得更长期的支持）
• 至少10GB的可用磁盘空间
• 稳定的网络连接
• 具有sudo权限的用户账户

检查系统状态

首先，打开终端（可以通过快捷键Ctrl+Alt+T或在应用程序菜单中找到”终端”），更新系统包列表并升级已安装的包：
  2. sudo apt update
  3. sudo apt upgrade -y
复制代码

检查系统是否已安装Python：
  2. python3 --version
复制代码

如果系统已预装Python，你将看到类似Python 3.x.x的输出。Ubuntu MATE通常预装了Python 3，但可能不是最新版本。

Python安装方法

方法一：使用系统包管理器安装（APT）

这是最简单、最推荐的安装方法，特别适合新手。APT（Advanced Package Tool）是Ubuntu及其衍生版的默认包管理器。

Ubuntu MATE的软件仓库中通常包含Python的最新稳定版本。要安装Python 3，请执行以下命令：
  2. sudo apt install python3
复制代码

安装完成后，验证安装：
  2. python3 --version
复制代码

注意：Python 2已于2020年1月1日停止官方支持，不推荐用于新项目。但如果需要运行旧代码，可以安装Python 2：
  2. sudo apt install python
复制代码

验证安装：
  2. python --version
复制代码

pip是Python的包管理器，用于安装和管理Python包。安装Python 3后，可以安装pip：
  2. sudo apt install python3-pip
复制代码

验证pip安装：
  2. pip3 --version
复制代码

如果你计划开发需要编译C扩展的Python包，安装开发工具：
  2. sudo apt install build-essential python3-dev
复制代码

方法二：从源代码编译安装

从源代码编译安装Python允许你安装最新版本的Python，并可以自定义安装选项。这种方法适合需要特定Python版本或自定义配置的用户。

首先，安装编译Python所需的依赖：
  2. sudo apt update
  3. sudo apt install wget build-essential libreadline-dev libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev zlib1g-dev
复制代码

访问Python官方网站（https://www.python.org/downloads/）获取最新版本的下载链接，或使用wget命令直接下载。例如，下载Python3.10.6：
  2. wget https://www.python.org/ftp/python/3.10.6/Python-3.10.6.tgz
复制代码

解压下载的源代码：
  2. tar -xf Python-3.10.6.tgz
  3. cd Python-3.10.6
复制代码

配置编译选项：
  2. ./configure --enable-optimizations
复制代码

--enable-optimizations选项会优化Python二进制文件，但会增加编译时间。

开始编译：
  2. make -j 4
复制代码

-j 4选项表示使用4个CPU核心进行编译，可以根据你的系统配置调整。

安装编译好的Python：
  2. sudo make altinstall
复制代码

使用altinstall而不是install可以避免覆盖系统默认的Python版本。
  2. python3.10 --version
复制代码

你应该看到类似Python 3.10.6的输出。

方法三：使用Pyenv管理多个Python版本

Pyenv是一个优秀的Python版本管理工具，允许你在同一系统上轻松切换多个Python版本。

首先，安装Pyenv所需的依赖：
  2. sudo apt update
  3. sudo apt install make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
复制代码

使用官方安装脚本安装Pyenv：
  2. curl https://pyenv.run | bash
复制代码

将以下内容添加到你的shell配置文件中（~/.bashrc、~/.zshrc或其他）：
  2. echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
  3. echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
  4. echo 'eval "$(pyenv init -)"' >> ~/.bashrc
复制代码

重新加载shell配置：
  2. source ~/.bashrc
复制代码

查看可用的Python版本：
  2. pyenv install --list
复制代码

安装特定版本的Python（例如3.10.6）：
  2. pyenv install 3.10.6
复制代码

设置全局Python版本：
  2. pyenv global 3.10.6
复制代码

验证安装：
  2. python --version
复制代码

环境配置

设置PATH环境变量

如果你从源代码编译安装了Python，或者希望使用特定版本的Python，可能需要设置PATH环境变量。

打开shell配置文件（例如~/.bashrc）：
  2. nano ~/.bashrc
复制代码

添加以下行（根据你的Python安装路径进行调整）：
  2. export PATH="/usr/local/bin:$PATH"
复制代码

保存并关闭文件，然后重新加载配置：
  2. source ~/.bashrc
复制代码

虚拟环境设置

虚拟环境允许你在隔离的环境中安装Python包，避免包之间的冲突。

Python 3.3及以上版本内置了venv模块。创建一个新目录并设置虚拟环境：
  2. mkdir myproject
  3. cd myproject
  4. python3 -m venv venv
复制代码

激活虚拟环境：
  2. source venv/bin/activate
复制代码

激活后，你的命令提示符应该显示(venv)，表示你处于虚拟环境中。

在虚拟环境中安装包：
  2. pip install package-name
复制代码

退出虚拟环境：
  2. deactivate
复制代码

virtualenv是一个更强大的虚拟环境工具，支持Python 2和Python 3。

首先安装virtualenv：
  2. pip install virtualenv
复制代码

创建虚拟环境：
  2. virtualenv myenv
复制代码

激活虚拟环境：
  2. source myenv/bin/activate
复制代码

退出虚拟环境：
  2. deactivate
复制代码

pip配置和使用

pip是Python的包管理器，用于安装和管理Python包。

安装包：
  2. pip install package-name
复制代码

安装特定版本的包：
  2. pip install package-name==1.0.0
复制代码

升级包：
  2. pip install --upgrade package-name
复制代码

卸载包：
  2. pip uninstall package-name
复制代码

列出已安装的包：
  2. pip list
复制代码

查看包信息：
  2. pip show package-name
复制代码

默认情况下，pip从PyPI（Python Package Index）下载包。在中国大陆等地区，你可能希望使用镜像源以提高下载速度。

创建或编辑pip配置文件：
  2. mkdir -p ~/.pip
  3. nano ~/.pip/pip.conf
复制代码

添加以下内容（使用清华大学镜像源）：
  2. [global]
  3. index-url = https://pypi.tuna.tsinghua.edu.cn/simple
  4. trusted-host = pypi.tuna.tsinghua.edu.cn
复制代码

保存并关闭文件。

在项目中使用requirements.txt文件记录依赖包：

生成requirements.txt：
  2. pip freeze > requirements.txt
复制代码

从requirements.txt安装依赖：
  2. pip install -r requirements.txt
复制代码

常见问题解决

版本冲突问题

解决方案：

1. 使用python3命令明确指定Python 3版本：
  2. python3 script.py
复制代码

1. 使用update-alternatives管理系统Python版本：
  2. sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 1
复制代码

1. 使用Pyenv管理多个Python版本（如前所述）。

解决方案：

1. 使用虚拟环境隔离项目依赖：
  2. python3 -m venv myenv
  3. source myenv/bin/activate
  4. pip install package-name
复制代码

1. 使用--user选项将包安装到用户目录：
  2. pip install --user package-name
复制代码

权限问题

解决方案：

1. 使用--user选项：
  2. pip install --user package-name
复制代码

1. 配置用户级别的pip安装目录：
  2. echo 'export PIP_USER=true' >> ~/.bashrc
  3. source ~/.bashrc
复制代码

1. 避免使用sudo pip install，这可能会导致系统包管理器问题。

解决方案：

1. 确保你有sudo权限：
  2. sudo make altinstall
复制代码

1. 将Python安装到用户目录：
  2. ./configure --prefix=$HOME/.local
  3. make
  4. make install
复制代码

依赖问题

解决方案：

1. 安装常见的Python编译依赖：
  2. sudo apt install build-essential python3-dev libssl-dev libffi-dev
复制代码

1. 根据错误信息安装特定的依赖包。例如，如果缺少zlib依赖：
  2. sudo apt install zlib1g-dev
复制代码

解决方案：

1. 查看错误信息，确定缺少的系统依赖。
2. 使用apt安装缺少的依赖。例如，如果安装lxml时缺少libxml2：
  2. sudo apt install libxml2-dev libxslt1-dev
复制代码

编译错误

解决方案：

1. 确保安装了所有必要的编译依赖：
  2. sudo apt install build-essential libreadline-dev libncursesw5-dev libssl-dev libsqlite3-dev tk-dev libgdbm-dev libc6-dev libbz2-dev libffi-dev zlib1g-dev
复制代码

1. 清理之前的编译尝试：
  2. make clean
复制代码

1. 重新配置和编译：
  2. ./configure --enable-optimizations
  3. make -j 4
  4. sudo make altinstall
复制代码

解决方案：

1. 确保模块已安装：
  2. pip install module-name
复制代码

1. 检查Python路径：
  2. python3 -c "import sys; print(sys.path)"
复制代码

1. 确保你在正确的Python环境中（例如，在虚拟环境中）。

进阶配置

IDE配置

Visual Studio Code是一个流行的轻量级代码编辑器，对Python有很好的支持。

安装VS Code：
  2. sudo apt install code
复制代码

或者从官方网站下载并安装。

安装Python扩展：

1. 打开VS Code
2. 按Ctrl+P，输入ext install ms-python.python
3. 点击”安装”按钮

配置Python解释器：

1. 按Ctrl+Shift+P，输入Python: Select Interpreter
2. 选择你想要使用的Python解释器

PyCharm是一个功能强大的Python IDE，有社区版（免费）和专业版（付费）。

安装PyCharm Community Edition：
  2. sudo snap install pycharm-community --classic
复制代码

或者从官方网站下载并安装。

配置Python解释器：

1. 打开PyCharm
2. 创建或打开项目
3. 进入File > Settings > Project > Python Interpreter
4. 点击齿轮图标，选择Add...
5. 选择你想要使用的Python解释器

Jupyter Notebook是一个交互式计算环境，广泛用于数据科学和教学。

安装Jupyter：
  2. pip install jupyter
复制代码

启动Jupyter Notebook：
  2. jupyter notebook
复制代码

开发环境优化

安装并配置pylint进行代码检查：
  2. pip install pylint
复制代码

在VS Code中配置pylint：

1. 打开VS Code设置（Ctrl+,）
2. 搜索”pylint”
3. 确保”Python > Linting: Pylint Enabled”选项已启用

安装并配置jedi进行自动补全：
  2. pip install jedi
复制代码

安装black代码格式化工具：
  2. pip install black
复制代码

在VS Code中配置black：

1. 打开VS Code设置（Ctrl+,）
2. 搜索”python formatting”
3. 将”Python > Formatting: Provider”设置为”black”

安装Git：
  2. sudo apt install git
复制代码

配置Git用户信息：
  2. git config --global user.name "Your Name"
  3. git config --global user.email "your.email@example.com"
复制代码

初始化Git仓库：
  2. cd your-project-directory
  3. git init
复制代码

总结

在Ubuntu MATE系统上安装和配置Python环境是开始Python编程的重要一步。本指南详细介绍了三种安装Python的方法：使用系统包管理器、从源代码编译安装和使用Pyenv管理多个版本。我们还讨论了环境配置、虚拟环境设置、pip使用以及常见问题解决方案。

对于新手，推荐使用系统包管理器安装Python，这是最简单、最可靠的方法。随着经验的积累，你可以尝试使用Pyenv管理多个Python版本，或从源代码编译安装以获得更多自定义选项。

正确配置Python环境，包括使用虚拟环境和合理配置pip，将帮助你避免许多常见的依赖和版本冲突问题。此外，选择合适的IDE和开发工具将显著提高你的开发效率。

希望本指南能帮助你在Ubuntu MATE系统上顺利安装和配置Python环境，开启你的Python编程之旅！
网络连接, 扮演着, 磁盘空间
「七転び八起き（ななころびやおき）」
回复

使用道具 举报

返回列表 发新帖
您需要登录后才可以回帖 登录 | 立即注册
高级模式
B Color Image Link Quote Code Smilies

本版积分规则