在树莓派上安装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
注意事项:
- 权限问题:建议使用虚拟环境,避免使用
sudo pip - 空间管理:树莓派存储有限,定期清理缓存
- 电源:编译安装时确保供电稳定
- 备份:重要项目使用git管理
推荐配置:
对于树莓派4B 4GB以上版本,可以安装完整的数据科学环境:
bash复制下载
# 安装Miniconda(节省空间) wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-armv7l.sh bash Miniconda3-latest-Linux-armv7l.sh # 按照提示安装,然后重启终端
这样你就有了完整的Python开发环境,可以开始树莓派上的Python项目开发了!

相关内容