在树莓派上安装Python运行环境

在树莓派上安装Python运行环境非常方便,以下是详细步骤:

1. 检查现有Python版本

树莓派系统通常已预装Python,先检查版本:

bash复制下载

python3 --version
python --version  # 可能指向Python2

2. 更新系统包列表

bash复制下载

sudo apt update
sudo apt upgrade -y

3. 安装Python(如果需要更新)

安装Python 3.9+:

bash复制下载

sudo apt install python3 python3-pip -y

安装特定版本(如Python 3.11):

bash复制下载

sudo apt install python3.11 python3.11-venv python3.11-dev -y

4. 设置Python3为默认版本

bash复制下载

# 删除原有链接
sudo rm -f /usr/bin/python

# 创建新链接(替换3.11为你的版本)
sudo ln -s /usr/bin/python3.11 /usr/bin/python

# 检查
python --version

5. 安装pip和工具

bash复制下载

# 安装pip(如果未安装)
sudo apt install python3-pip -y

# 升级pip
python -m pip install --upgrade pip

# 安装常用工具
sudo apt install python3-venv python3-wheel python3-setuptools -y

6. 配置虚拟环境(推荐)

bash复制下载

# 安装虚拟环境工具
pip install virtualenv virtualenvwrapper

# 添加到bashrc
echo 'export WORKON_HOME=$HOME/.virtualenvs' >> ~/.bashrc
echo 'export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3' >> ~/.bashrc
echo 'source $HOME/.local/bin/virtualenvwrapper.sh' >> ~/.bashrc

# 使配置生效
source ~/.bashrc

# 创建虚拟环境示例
mkvirtualenv myproject
workon myproject  # 激活
deactivate        # 退出

7. 安装常用Python库

bash复制下载

# 基础科学计算库
sudo apt install python3-numpy python3-scipy python3-matplotlib -y

# GPIO控制(树莓派特有)
sudo apt install python3-rpi.gpio -y

# 其他常用库
pip install requests pillow pandas numpy matplotlib flask

8. 安装开发工具

bash复制下载

# 安装调试器和IDE
sudo apt install python3-pudb -y  # 文本界面调试器
pip install ipython jupyter notebook  # Jupyter环境

# 代码格式化工具
pip install black flake8 pylint

9. 验证安装

创建测试文件:

bash复制下载

cat > test.py << 'EOF'
import sys
import pip

print(f"Python版本: {sys.version}")
print(f"pip版本: {pip.__version__}")
print("Python环境运行正常!")

# 测试GPIO(可选)
try:
    import RPi.GPIO as GPIO
    print("GPIO库可用")
except ImportError:
    print("GPIO库不可用")
EOF

python test.py

10. 可选:编译安装最新Python版本

如果需要最新版本(如Python 3.12):

bash复制下载

# 安装编译依赖
sudo apt install build-essential zlib1g-dev \
libncurses5-dev libgdbm-dev libnss3-dev \
libssl-dev libreadline-dev libffi-dev \
libsqlite3-dev libbz2-dev -y

# 下载并编译
wget https://www.python.org/ftp/python/3.12.0/Python-3.12.0.tgz
tar -xf Python-3.12.0.tgz
cd Python-3.12.0
./configure --enable-optimizations
make -j$(nproc)
sudo make altinstall  # 使用altinstall避免覆盖系统Python

# 验证
python3.12 --version

11. 环境管理小贴士

bash复制下载

# 查看已安装包
pip list

# 生成requirements.txt
pip freeze > requirements.txt

# 从requirements.txt安装
pip install -r requirements.txt

# 清理pip缓存
pip cache purge

注意事项:

  1. 权限问题:建议使用虚拟环境,避免使用sudo pip
  2. 空间管理:树莓派存储有限,定期清理缓存
  3. 电源:编译安装时确保供电稳定
  4. 备份:重要项目使用git管理

推荐配置:

对于树莓派4B 4GB以上版本,可以安装完整的数据科学环境:

bash复制下载

# 安装Miniconda(节省空间)
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-armv7l.sh
bash Miniconda3-latest-Linux-armv7l.sh
# 按照提示安装,然后重启终端

这样你就有了完整的Python开发环境,可以开始树莓派上的Python项目开发了!