装 Python

一句话

部署脚本是 Python 写的，所以你的电脑上要有 Python。 服务器上什么都不用装 —— 脚本会自己装。

先看看你是不是已经有了

打开终端（Windows 按 Win + R，输 cmd 回车），敲：

python --version

看到 Python 3.9 或更高（比如 Python 3.12.4）就跳过这一页，直接去 一键部署。

看到 Python 2.7 或者报"不是内部或外部命令"

那就是没有（或者太老），照下面装一遍。

---

Windows

1. 下载

去 python.org/downloads，点那个大黄按钮 （Download Python 3.x.x）。

2. ⭐ 安装时勾上那一个框

安装界面最下面有一个 Add python.exe to PATH，必须勾上

不勾的话装完 python 这个命令在终端里还是找不到， 表现是"我明明装了啊"—— 这是这一步唯一会出错的地方。

勾完再点 Install Now。

3. 验证

关掉终端重新开一个（PATH 是新开的终端才读的），再敲一次：

python --version

---

macOS

系统自带的是 Python 3，通常直接能用。敲 python3 --version 看看。

没有或者想装新的：

brew install python

macOS 上命令是 python3

后面文档里写 python xxx 的地方，你敲 python3 xxx。

---

Linux（本机是 Linux 的话）

sudo apt install -y python3 python3-pip

---

再装一个依赖

部署脚本要用一个叫 paramiko 的库来连服务器（就是 SSH）：

pip install paramiko

报错 pip 不是内部或外部命令

说明 Python 装的时候没勾 PATH。重装一遍，勾上那个框。

macOS / Linux 上报 externally-managed-environment

换成：

pip3 install --user paramiko

检查一下

python -c "import paramiko; print('ok')"

打印 ok 就齐了。去 一键部署。

---

常见问题

python 打开的是微软商店

Windows 自带一个"假的" python 命令，会跳去应用商店。装完真的 Python 并勾了 PATH 之后就不会了。还跳的话，去 设置 → 应用 → 高级应用设置 → 应用执行别名， 把 python.exe 和 python3.exe 两个开关关掉。

公司电脑装不了软件

找 IT。或者用一台你有权限的电脑跑部署 —— 部署只需要跑一次， 之后维护也可以在任何一台装了 Python 的电脑上做（把 .secrets.json 带上）。

我完全不懂命令行

你只需要会两件事：

1. 打开终端（Windows：Win + R → 输 cmd → 回车）
2. 把命令粘贴进去，按回车

这份文档里所有代码块右边都有复制按钮。