在树莓派开发中，硬编码（Hardcoding） 指将本应动态配置的数据（如路径、参数、凭证等）直接写入源代码中，而非通过外部配置、环境变量或用户输入获取。这种做法虽简单，但会导致代码灵活性差、安全性低且难以维护。以下是详细说明和优化建议：

常见硬编码场景及风险

1. 敏感信息暴露

   # 硬编码示例（不推荐）
   WIFI_SSID = "MyHomeNetwork"
   WIFI_PASSWORD = "12345678"

   • 风险：密码直接暴露在代码中，若代码泄露会造成安全隐患。

2. 固定路径/设备号

   # 硬编码树莓派GPIO引脚
   LED_PIN = 18  # 直接指定GPIO18

   • 风险：若硬件连接变更（如LED改接到GPIO17），需修改代码并重新部署。

3. 固定网络配置

   SERVER_IP = "192.168.1.100"  # 服务器IP写死在代码中

   • 风险：服务器地址变更时，需重新修改并分发代码。

优化方案（避免硬编码）

1. 使用配置文件（推荐）

创建外部配置文件（如 config.json）存储动态参数：

   {
     "wifi_ssid": "MyNetwork",
     "wifi_password": "secure_password",
     "led_pin": 18,
     "server_ip": "192.168.1.100"
   }

代码中读取配置：

   import json
   with open("config.json") as f:
       config = json.load(f)

   LED_PIN = config["led_pin"]  # 动态获取引脚号

2. 环境变量

通过系统环境变量传递敏感信息（如密码）：

   # 终端中设置环境变量（临时）
   export WIFI_PASSWORD="secure_password"

代码调用：

   import os
   password = os.environ.get("WIFI_PASSWORD")  # 安全读取

3. 命令行参数

运行脚本时动态传入参数：

   import argparse
   parser = argparse.ArgumentParser()
   parser.add_argument("--pin", type=int, help="GPIO引脚号")
   args = parser.parse_args()

   LED_PIN = args.pin  # 使用示例：python script.py --pin 18

4. 硬件抽象层

对硬件操作封装接口，隔离底层变动：

   # 硬件抽象类
   class LEDController:
       def __init__(self, pin):
           self.pin = pin
           self.setup()

       def setup(self):
           import RPi.GPIO as GPIO
           GPIO.setmode(GPIO.BCM)
           GPIO.setup(self.pin, GPIO.OUT)

   # 使用配置初始化
   led = LEDController(config["led_pin"])

树莓派专用注意事项

1. GPIO引脚管理

   • 使用GPIO Zero库，它支持引脚别名（如LED、Button），减少直接操作引脚编号。

     from gpiozero import LED
     led = LED(17)  # 仍可优化为从配置读取

2. 安全存储凭证

   • 使用raspi-config配置WiFi，而非代码存密码。
   • 密钥文件存放在/etc目录（需权限控制）。

3. 适应不同型号

   • 树莓派型号差异（如GPIO布局不同）可通过系统命令动态识别：

     import re
     model = re.search('Raspberry Pi (.+)', open('/proc/device-tree/model').read())

总结

始终遵循原则：将代码与配置分离，提升安全性、可移植性和可维护性。