Python 环境安装与配置指南 @

一、Python 安装 @

1.1 通过 PPA 源安装 Python 3.10 @

在 Ubuntu 系统中，推荐使用第三方维护的 PPA 软件源来安装特定版本的 Python，这样可以获得最新的版本和更好的兼容性。

# 添加 deadsnakes PPA 软件源（专门维护 Python 多个版本的第三方源）
sudo add-apt-repository ppa:deadsnakes/ppa

# 更新软件包列表
sudo apt-get update

# 安装 Python 3.10 及相关工具
sudo apt install python3.10 python3.10-distutils

注意事项：

python3.10-distutils 包含 Python 分发工具，为后续安装 pip 提供支持
建议使用 sudo 权限执行以上命令

1.2 设置 Python 默认版本 @

当系统中存在多个 Python 版本时，可以使用 update-alternatives 工具来管理默认版本。

# 注册 Python 3.8 到备选列表，优先级为 1
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1

# 注册 Python 3.10 到备选列表，优先级为 2（数字越大优先级越高）
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 2

# 交互式选择默认 Python 版本
sudo update-alternatives --config python3

操作说明：

执行 --config 命令后会显示可选版本列表
输入对应数字选择要设置的默认版本
按回车键确认选择

二、Pip 包管理工具安装 @

2.1 Python 3 环境 pip 安装 @

# 方法一：使用官方脚本安装（推荐）
curl -sS https://bootstrap.pypa.io/get-pip.py | python3.10

# 方法二：下载脚本后安装
wget https://bootstrap.pypa.io/get-pip.py
python3.10 get-pip.py

2.2 Python 2 环境 pip 安装（如需要） @

# 下载 Python 2.7 版本的 pip 安装脚本
wget https://bootstrap.pypa.io/pip/2.7/get-pip.py

# 使用国内镜像源加速安装
python get-pip.py -i http://pypi.douban.com/simple --trusted-host pypi.douban.com

三、环境管理与版本查看 @

3.1 版本信息查询 @

# 查看当前 Python 3 版本
python3 --version

# 查看所有已安装的 Python 版本
ls /usr/bin/python*

# 列出通过 alternatives 管理的 Python 版本
sudo update-alternatives --list python

3.2 版本管理操作 @

# 卸载指定版本的 Python（谨慎操作）
sudo apt remove –autoremove python3.10

# 从 alternatives 系统中移除某个版本
sudo update-alternatives --remove python /usr/bin/python2.7

四、Pip 源配置优化 @

4.1 使用命令行配置镜像源 @

为了提高包下载速度，建议配置国内镜像源：

# 配置阿里云镜像源（推荐）
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

# 配置腾讯云镜像源
pip config set global.index-url http://mirrors.cloud.tencent.com/pypi/simple

# 配置豆瓣镜像源
pip config set global.index-url http://pypi.douban.com/simple/

4.2 手动编辑配置文件 @

除了使用命令行，也可以直接编辑配置文件：

# 创建或编辑 pip 配置文件
vim ~/.pip/pip.conf

# 文件内容如下：
[global]
index-url = http://mirrors.aliyun.com/pypi/simple/
trusted-host = mirrors.aliyun.com
timeout = 120

配置说明：

index-url: 指定包下载地址
trusted-host: 信任的域名（使用 http 协议时需要）
timeout: 设置超时时间，避免下载大包时超时

五、验证安装结果 @

完成所有安装和配置后，建议执行以下命令验证：

# 验证 Python 安装
python3 --version

# 验证 pip 安装
pip3 --version

# 测试 pip 是否能正常下载包
pip3 install --upgrade pip

通过以上步骤，成功搭建一个完整的 Python 开发环境

六、vscode配置python环境 @

launch.json

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": false,
        }
    ]
}

settings.json

// 配置unittest单元测试和linting代码格式
{
    "python.testing.unittestArgs": [
        "-v",
        "-s",
        "./tests",
        "-p",
        "test_*.py"
    ],
    "python.testing.pytestEnabled": false,
    "python.testing.unittestEnabled": true,
    "python.envFile": "${workspaceFolder}/.vscode/.env",
    // pylint   (check tool)
    "python.linting.enabled": true,
    // autopep8 (format tool)
    "python.formatting.provider": "autopep8",
    "python.formatting.autopep8Args": [
        "--max-line-length=200"
    ],
}