03 环境:树莓派环境配置
开始写代码之前,得先搭好舞台。

我用的主角是树莓派 5,虽然硬件已经就位,但如果开发环境配置不好,就像积木没拼紧,一碰就散。为了后续稳定开发,我决定直接在树莓派中运行和调试所有代码,避免"本地能跑,部署就炸"的尴尬。
🖥️ (1)用 PyCharm + SSH 打通开发通道
作为 Python 重度用户,PyCharm 是我最顺手的 IDE 工具。
我在电脑上配置了 远程 SSH 连接到的树莓派,之后就可以:
像本地一样打开树莓派上的文件夹;
自动完成语法提示、运行和调试;
保留代码、终端、日志的完整链路。
配置过程略微复杂,我就不赘述了,放一张图说明

🐍**(2)配置远程 Python 环境 ------ 稳定优先**
树莓派上预装的 Python 版本可能不一致,为了避免模块不兼容,我手动装了一个稳定版本 Python 3.10 并设为默认运行环境。
然后在 PyCharm 设置中指向远程树莓派 /usr/bin/python3.10,一切搞定。
🔁(3)设置文件同步:写一行,远程即更新
好处是:本地写的每一行代码,都会自动同步到树莓派上指定的目录。这点靠的是 PyCharm 的 Deployment 功能(Settings → Deployment)。
你只需配置:
本地路径 ⇄ 远程路径映射
保存文件时自动上传。
这样我每次点击保存,树莓派的代码就更新,无需手动 SCP、rsync,省心省事。

✅**(4)第一次运行 Hello World:它说话了!**
一切准备就绪后,我在 PyCharm 里打开 main.py,写下那句经典的:
print("Hello, AI world!")
点击运行按钮那一刻,看着远程树莓派终端弹出这行文字,我真的有点小激动。
这是我助手的第一声回应------尽管还没开口说话,但它,活着了。

🧠 经验 Tips(给未来的你):
一定要让开发环境尽可能统一(本地 ⇄ 部署),后期避免一堆奇怪的"版本冲突";
能在树莓派上跑就别用 PC 模拟,特别是语音相关模块,对系统调用和音频驱动很敏感。
🧾 声明:所有内容均为我非工作时间的个人开发探索,技术探索过程公开透明,旨在分享语音交互领域的实战经验,不代表任何单位或组织,不涉及任何职务行为或工作成果,仅供学习参考。