# 树莓派Python编程完整指南 ## 1. 环境准备与Python版本确认 ### 1.1 检查Python版本 树莓派通常预装了Python，首先需要确认当前系统可用的Python版本： ```bash # 检查Python 2.x版本（已过时，不推荐使用） python --version # 检查Python 3.x版本（推荐使用） python3 --version # 查看所有已安装的Python版本 ls /usr/bin/python* ``` 大多数现代树莓派系统都预装了Python 3.x版本，建议使用Python 3进行开发[ref_6]。 ### 1.2 更新软件包管理器 在开始编程前，建议更新系统软件包： ```bash sudo apt update sudo apt upgrade ``` ## 2. Python程序编写方法 ### 2.1 使用命令行编辑器 #### Vi/Vim编辑器（系统自带） ```bash # 创建并编辑Python文件 vi hello.py ``` 在Vi编辑器中输入以下内容： ```python #!/usr/bin/env python3 print("Hello World!") ``` 保存并退出（按ESC，然后输入`:wq`）[ref_3]。 #### Nano编辑器（更适合新手） ```bash # 使用nano创建Python文件 nano hello.py ``` 输入相同的内容，按`Ctrl+X`，然后按`Y`确认保存。 ### 2.2 使用Thonny IDE（图形化界面） Thonny是树莓派官方推荐的Python IDE，特别适合初学者： ```bash # 安装Thonny（如果未预装） sudo apt install thonny # 启动Thonny thonny ``` 在Thonny中创建新文件，输入代码后可直接运行，无需命令行操作[ref_2]。 ## 3. 运行Python程序 ### 3.1 命令行运行方式 ```bash # 直接运行Python 3程序 python3 hello.py # 或者使文件具有可执行权限 chmod +x hello.py ./hello.py ``` ### 3.2 交互式Python解释器 ```bash # 启动Python 3交互式环境 python3 # 在交互环境中直接执行代码 >>> print("Hello from interactive mode!") >>> 2 + 3 5 >>> exit() ``` ## 4. 实用Python编程示例 ### 4.1 基础I/O操作示例 ```python #!/usr/bin/env python3 # 文件名：basic_io.py # 用户输入 name = input("请输入您的名字: ") age = int(input("请输入您的年龄: ")) # 格式化输出 print(f"您好 {name}，您今年 {age} 岁！") print("明年您将 {} 岁".format(age + 1)) # 文件操作 with open('test.txt', 'w') as f: f.write(f"用户信息: {name}, {age}岁\n") print("信息已保存到test.txt文件") ``` ### 4.2 GPIO控制LED灯（硬件交互） ```python #!/usr/bin/env python3 # 文件名：led_control.py import RPi.GPIO as GPIO import time # 设置GPIO模式 GPIO.setmode(GPIO.BCM) LED_PIN = 18 # 使用GPIO18引脚 # 设置引脚为输出模式 GPIO.setup(LED_PIN, GPIO.OUT) try: print("开始控制LED灯...") for i in range(10): # 闪烁10次 GPIO.output(LED_PIN, GPIO.HIGH) # 点亮LED print(f"第{i+1}次点亮") time.sleep(0.5) # 等待0.5秒 GPIO.output(LED_PIN, GPIO.LOW) # 熄灭LED print(f"第{i+1}次熄灭") time.sleep(0.5) # 等待0.5秒 finally: # 清理GPIO资源 GPIO.cleanup() print("程序结束，GPIO已清理") ``` 运行前需要安装RPi.GPIO库： ```bash sudo apt install python3-rpi.gpio ``` ### 4.3 数据采集与处理示例 ```python #!/usr/bin/env python3 # 文件名：sensor_data.py import random import time from datetime import datetime class MockSensor: """模拟传感器数据采集""" def read_temperature(self): """模拟读取温度传感器数据""" return round(20 + random.uniform(-5, 5), 2) def read_humidity(self): """模拟读取湿度传感器数据""" return round(50 + random.uniform(-10, 10), 2) def log_sensor_data(filename='sensor_log.csv'): """记录传感器数据到文件""" sensor = MockSensor() # 创建CSV文件头（如果文件不存在） try: with open(filename, 'x') as f: f.write("时间戳,温度(℃),湿度(%)\n") except FileExistsError: pass # 采集并记录数据 for i in range(5): timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S") temperature = sensor.read_temperature() humidity = sensor.read_humidity() # 写入数据 with open(filename, 'a') as f: f.write(f"{timestamp},{temperature},{humidity}\n") print(f"记录 {i+1}: 时间={timestamp}, 温度={temperature}℃, 湿度={humidity}%") time.sleep(2) # 每2秒采集一次 if __name__ == "__main__": log_sensor_data() print("数据采集完成！") ``` ## 5. 项目管理与最佳实践 ### 5.1 创建项目目录结构 ```bash # 创建项目目录 mkdir my_python_project cd my_python_project # 创建标准的项目结构 mkdir src tests docs data touch src/__init__.py touch requirements.txt touch README.md # 创建主程序文件 touch src/main.py ``` ### 5.2 使用虚拟环境（推荐） ```bash # 安装虚拟环境工具 sudo apt install python3-venv # 创建虚拟环境 python3 -m venv myproject_env # 激活虚拟环境 source myproject_env/bin/activate # 在虚拟环境中安装包 pip install requests numpy # 退出虚拟环境 deactivate ``` ### 5.3 依赖管理 创建`requirements.txt`文件： ``` RPi.GPIO==0.7.0 requests==2.25.1 numpy==1.19.5 ``` 安装依赖： ```bash pip install -r requirements.txt ``` ## 6. 高级功能配置 ### 6.1 开机自启动Python程序 创建系统服务实现开机自启动： ```bash # 创建服务文件 sudo nano /etc/systemd/system/mypython.service ``` 服务文件内容： ```ini [Unit] Description=My Python Application After=network.target [Service] Type=simple User=pi WorkingDirectory=/home/pi/my_python_project ExecStart=/usr/bin/python3 /home/pi/my_python_project/src/main.py Restart=always RestartSec=10 [Install] WantedBy=multi-user.target ``` 启用服务： ```bash sudo systemctl enable mypython.service sudo systemctl start mypython.service ``` ### 6.2 定时任务执行 使用cron实现定时执行Python脚本： ```bash # 编辑cron任务 crontab -e # 添加以下行，表示每天上午9点执行 0 9 * * * /usr/bin/python3 /home/pi/my_python_project/daily_task.py # 每5分钟执行一次 */5 * * * * /usr/bin/python3 /home/pi/my_python_project/monitor.py ``` ## 7. 调试与问题排查 ### 7.1 常见错误处理 ```python #!/usr/bin/env python3 # 文件名：error_handling.py def safe_division(a, b): """安全的除法运算""" try: result = a / b except ZeroDivisionError: print("错误：除数不能为零！") return None except TypeError: print("错误：参数类型不正确！") return None else: print(f"计算结果: {a} / {b} = {result}") return result finally: print("除法运算完成") # 测试错误处理 safe_division(10, 2) safe_division(10, 0) safe_division(10, "2") ``` ### 7.2 日志记录 ```python #!/usr/bin/env python3 import logging # 配置日志 logging.basicConfig( level=logging.DEBUG, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s', handlers=[ logging.FileHandler('app.log'), logging.StreamHandler() ] ) logger = logging.getLogger(__name__) def main(): logger.info("程序启动") try: # 你的主要逻辑 result = 10 / 2 logger.debug(f"计算结果是: {result}") except Exception as e: logger.error(f"发生错误: {e}") finally: logger.info("程序结束") if __name__ == "__main__": main() ``` 通过以上完整的指南，您可以在树莓派上熟练地进行Python编程，从基础的环境配置到高级的项目管理，涵盖了实际开发中需要的各种技能和最佳实践。