Raspberry Pi Pico W 5V供电时无法自动执行main.py的问题求助

1. 确认文件的位置与命名 #

• 必须将main.py放在Pico W的根目录，不能嵌套在子文件夹中。用USB连接电脑时，在Thonny中保存文件时要选择Pico的根路径（而非本地电脑目录）。
• 文件名严格为小写的main.py，Pico的MicroPython环境对文件名大小写敏感，Main.py或MAIN.PY都无法被识别为开机执行脚本。

2. 排查电源稳定性问题 #

• 9V电池转5V的模块常存在压降、纹波过大或电流输出不足的问题，Pico W的WiFi模块启动瞬间需要至少1A的峰值电流，供电不足会导致设备无法完成初始化，自然不会执行脚本。
• 先换用稳定的USB电源测试，确认脚本能正常自动执行后，再更换质量可靠的5V降压模块（推荐带滤波电容的型号），同时检查面包板电源轨的接触是否牢固，避免虚接。

3. 确认自动执行机制未被临时禁用 #

• Pico W默认只要根目录存在main.py就会开机自动执行，但如果之前按住BOOTSEL键进入过安全模式，会临时禁用自动执行逻辑。解决方法：完全断电后，正常开机（不要按BOOTSEL键）即可恢复。
• 可以给main.py添加一段前置测试代码，直观判断脚本是否启动：

  from machine import Pin
  import time
  
  led = Pin("LED", Pin.OUT)
  # 脚本启动标记：快速闪烁3次
  for _ in range(3):
      led.on()
      time.sleep(0.1)
      led.off()
      time.sleep(0.1)
  # 后续WiFi连接逻辑...
  

  如果开机后LED闪3次，说明脚本已执行，问题出在后续WiFi或代码逻辑；如果没反应，再排查其他原因。

4. 修复文件系统异常 #

• 偶尔Pico的文件系统会出现读取异常，导致无法加载main.py。可以通过USB连接Thonny，在Shell中执行import os; os.listdir()，确认根目录下存在main.py；如果文件存在但无法执行，重新保存一次main.py，或执行import machine; machine.reset()强制重启设备。
• 若问题持续，可重新烧录MicroPython固件（注意备份文件），彻底重置文件系统。

5. 检查电源引脚连接正确性 #

• 电池供电时，5V输入需接Pico的VBUS引脚，3.3V-5.5V范围的输入可接VSYS引脚，不要接错引脚（比如误接3.3V引脚会导致供电不足）。同时确保GND引脚可靠接地。

内容的提问来源于stack exchange，提问作者harryt