打开命令提示符或终端

安装或更新 TWS API 的 Python client，需要在终端里执行命令。这里的“终端”可以是 Windows 的命令提示符、Windows Terminal，也可以是 macOS / Linux 的 Terminal。

这一步的重点不是选择哪个界面好看，而是确认两件事：

如果这两件事没确认，后面即使安装命令显示成功，也可能装到另一个 Python 环境里。

Windows 上打开终端

Windows 推荐使用命令提示符，或在 Windows Terminal 里打开命令提示符标签页。后续示例统一使用 cmd 风格命令，路径里有空格时用英文双引号。

常见打开方式：

方式	操作
命令提示符	开始菜单搜索 `cmd`。
Windows Terminal	开始菜单搜索 `Terminal` 或 `Windows Terminal`，再选择命令提示符。
文件夹内打开	在目标文件夹地址栏输入 `cmd` 后回车。

普通安装到虚拟环境时，不需要管理员权限。只有你明确要把包安装到系统 Python，或者系统目录权限不足时，才考虑管理员终端。新手更推荐虚拟环境或明确的项目 Python。

macOS 可以使用系统自带 Terminal：

Applications → Utilities → Terminal

也可以按 Command + Space 打开 Spotlight，搜索 Terminal。

macOS 上常见 Python 命令可能是 python3，不是 python。不要凭感觉判断，打开终端后先打印真实路径：

python3 -c "import sys; print(sys.executable); print(sys.version)"

如果你使用虚拟环境，应该调用虚拟环境里的 Python，而不是系统 Python。

Linux 桌面环境通常可以从应用菜单打开 Terminal。服务器环境通常通过 SSH 登录：

ssh user@example.com

服务器上要特别注意：SSH 只给你命令行，不代表 IB Gateway 的图形登录窗口已经可用。安装 Python client 可以通过 SSH 完成，但登录 IB Gateway、处理重新认证和查看 API 设置仍然需要图形会话或远程桌面。

Linux 上常见 Python 命令是：

python3

先确认路径：

python3 -c "import sys; print(sys.executable); print(sys.version)"

打开终端后，先确认所在目录：

cd

在 Windows 里，切换到某个目录：

cd "C:\TWS API\source\pythonclient"

路径有空格时必须加引号。不要把上面的路径当作固定路径；你的 TWS API 安装位置可能不同。后续页面会单独说明如何进入官方 Python client 源码目录。

macOS / Linux 写法类似：

API_ROOT="/path/to/TWS API"
cd "$API_ROOT/source/pythonclient"

如果目录不存在，先不要运行安装命令。应先确认你下载的是官方 TWS API 包，而不是只安装了 TWS 或 IB Gateway。

在终端里运行：

python -c "import sys; print(sys.executable); print(sys.version)"

如果你使用项目虚拟环境，Windows 写法通常是：

.\.venv\Scripts\python.exe -c "import sys; print(sys.executable); print(sys.version)"

macOS / Linux 虚拟环境常见写法是：

./.venv/bin/python -c "import sys; print(sys.executable); print(sys.version)"

确认输出里的路径就是你后续要用来运行 TWS API 脚本的 Python。后面安装 ibapi 时，也要用同一个 Python 执行：

python -m pip install .

或者：

.\.venv\Scripts\python.exe -m pip install .

同一台电脑上可能同时存在 python、python3、py、虚拟环境 Python、IDE 内置 Python。它们不一定是同一个环境。

命令	风险
`python`	可能指向系统默认 Python，也可能来自环境变量。
`python3`	macOS / Linux 常见，但仍要确认路径。
`py`	Windows Python Launcher，可能指向旧版本或已删除版本。
`.venv\Scripts\python.exe`	更明确，适合项目内运行。
IDE 的运行按钮	可能使用 IDE 自己选择的解释器。

如果安装时用的是一个 Python，运行脚本时却用另一个 Python，就会出现 ModuleNotFoundError: No module named 'ibapi'。

明确调用虚拟环境 Python 时，成功输出通常类似：

D:\your-project\.venv\Scripts\python.exe
Python 3.10.5
D:\your-project\.venv\lib\site-packages\ibapi\__init__.py

如果 py 启动器指向不可用路径，不需要继续围绕 py 排查；直接使用确定存在的 Python 路径即可。

现象	原因	处理方式
`cd` 提示找不到路径	TWS API 包目录不在你输入的位置，或只安装了 TWS 客户端。	先找到实际 TWS API 安装目录，再进入 `source\pythonclient`。
路径里有空格导致命令失败	没有给路径加引号。	使用 `"D:\TWS API\source\pythonclient"` 这种写法。
`python` 能运行但导入不了 `ibapi`	这个 Python 没安装官方 API 包。	用同一个 Python 执行 `-m pip install .`。
`py` 报错或指向奇怪路径	Windows Python Launcher 配置或旧版本残留。	不死磕 `py`，改用明确存在的 `python.exe`。
IDE 能运行，终端不能运行	IDE 和终端使用的 Python 不同。	在 IDE 和终端分别打印 `sys.executable` 对比。

IBKR TWS API Documentation：官方在 Updating The Python Interpreter 主题下把打开命令提示符或终端作为安装 Python client 的第一步；后续步骤会进入 Python 源码目录并运行安装脚本。