树莓派OS安装

树莓派OS的安装非常简单，只要准备好一张带读卡器的SD卡或U盘，然后通过Raspberry Pi Imager来安装即可。首次启动的时候需要设置一下WIFI连接的密码，设置好即可。另外最好把hostname改一下，并打开ssh连接，第二次连接的时候就可以直接通过ssh hostname.local连接了。

安装1panel远程管理树莓派（可选）

如果你的树莓派内存比较大，可以安装1panel来进行远程管理，因为1panel会帮你把docker也安装了，所以可能会需要比较大的内存来运行，我的树莓派是8G的内存，绰绰有余，所以我安装了。

首先需要启用root用户

sudo passwd root

设置root密码

然后解锁root用户

sudo passwd --unlock root

切换到root用户，运行以下脚步安装1panel即可。

bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

修改国内源（可选）

使用国内源可以加速APT，运行以下代码修改即可。

sudo sed 's/deb.debian.org/mirrors.aliyun.com/g' /etc/apt/sources.list -i

sudo apt update

pip更换国内源

pip3 config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装指定版本的python(可选)

我的树莓派默认安装的python版本是3.13.5，有些库只支持python3.9，可以参考这篇博文安装旧版python（https://blog.csdn.net/AbaAbaxxx_/article/details/142971433）

安装UV管理python（可选）

# step 1
sudo apt update
sudo apt install snapd

# step 2
sudo reboot

# step 3
sudo snap install snapd

# step 4
sudo snap install astral-uv --classic

输入uv就可以查看所有的uv命令

mlk@mlkpi:~ $ uv
An extremely fast Python package manager.

Usage: uv [OPTIONS] <COMMAND>

Commands:
  auth     Manage authentication
  run      Run a command or script
  init     Create a new project
  add      Add dependencies to the project
  remove   Remove dependencies from the project
  version  Read or update the project's version
  sync     Update the project's environment
  lock     Update the project's lockfile
  export   Export the project's lockfile to an alternate format
  tree     Display the project's dependency tree
  format   Format Python code in the project
  tool     Run and install commands provided by Python packages
  python   Manage Python versions and installations
  pip      Manage Python packages with a pip-compatible interface
  venv     Create a virtual environment
  build    Build Python packages into source distributions and wheels
  publish  Upload distributions to an index
  cache    Manage uv's cache
  self     Manage the uv executable
  help     Display documentation for a command

设置uv的国内源

export UV_DEFAULT_INDEX="https://mirrors.aliyun.com/pypi/simple"

查看python版本

mlk@mlkpi:~ $ uv python list
cpython-3.14.0rc2-linux-aarch64-gnu                 <download available>
cpython-3.14.0rc2+freethreaded-linux-aarch64-gnu    <download available>
cpython-3.13.7-linux-aarch64-gnu                    <download available>
cpython-3.13.7+freethreaded-linux-aarch64-gnu       <download available>
cpython-3.13.5-linux-aarch64-gnu                    /usr/bin/python3.13
cpython-3.13.5-linux-aarch64-gnu                    /usr/bin/python3 -> python3.13
cpython-3.13.5-linux-aarch64-gnu                    /usr/bin/python -> python3
cpython-3.12.11-linux-aarch64-gnu                   <download available>
cpython-3.11.13-linux-aarch64-gnu                   <download available>
cpython-3.10.18-linux-aarch64-gnu                   <download available>
cpython-3.9.23-linux-aarch64-gnu                    <download available>
cpython-3.8.20-linux-aarch64-gnu                    <download available>
pypy-3.11.13-linux-aarch64-gnu                      <download available>
pypy-3.10.16-linux-aarch64-gnu                      <download available>
pypy-3.9.19-linux-aarch64-gnu                       <download available>
pypy-3.8.16-linux-aarch64-gnu                       <download available>
graalpy-3.11.0-linux-aarch64-gnu                    <download available>
graalpy-3.10.0-linux-aarch64-gnu                    <download available>
graalpy-3.8.5-linux-aarch64-gnu                     <download available>

可以看出我的树莓派只安装了python 3.13.5版本，但是我要做个语音助理应用，用到的库只支持python 3.9版本，所以可以通过以下命名安装python3.9版本

uv python install 3.9.23

指定python版本

uv python pin 3.9.23

创建并激活虚拟环境：

# 创建名为 .venv 的虚拟环境（默认）
uv venv

# 激活环境（macOS/Linux）
source .venv/bin/activate

# 激活环境（Windows）
.venv\Scripts\activate