TWS 在线版或离线版？
IBKR 的 TWS 有在线 / 云端入口，也有 Offline Installer（离线独立安装包）。IB Gateway 也有 Latest 和 Stable 版本。选择哪个版本，会影响版本更新、问题复现和服务器维护方式。
官方入口：
| 场景 | 建议 |
|---|---|
| Windows 桌面学习和开发 | TWS 最新版本 |
| 需要固定版本复现问题 | TWS Offline Installer |
| Linux 服务器运行 | IB Gateway Stable 或 Latest |
| 想减少频繁变化 | Stable / Offline |
| 想用最新功能 | Latest |
推荐组合：
- Windows 桌面开发：使用 TWS，保持版本较新。
- Linux 服务器：使用 IB Gateway，优先考虑 Stable，除非需要 Latest 的新功能。
在线版 / 云端版本
Section titled “在线版 / 云端版本”在线版或云端入口的优点是：
- 获取更快。
- 更容易保持最新版本。
- 适合普通交易和桌面调试。
- 对新手更省心，不需要手动管理安装包版本。
缺点是：
- 版本变化可能更频繁。
- 如果你在排查 API 行为差异，版本变化会增加复现难度。
对于新手，这通常不是大问题。先跑通流程比固定版本更重要。
Offline Installer
Section titled “Offline Installer”TWS Offline Installer 的特点是：安装包包含安装和运行对应生产版本所需内容；安装后不会自动更新。如果 IBKR 发布了新的 TWS Latest，你需要重新下载安装包并手动安装。
它适合：
- 固定版本排查问题。
- 团队希望界面和行为短期内保持一致。
- 某些团队需要更可控的升级节奏。
它不适合：
- 想一直自动使用最新版本。
- 不愿意手动维护版本。
- 完全不记录安装版本的团队。
下载离线安装包以后，建议记录：
| 记录项 | 作用 |
|---|---|
| 下载日期 | 方便判断当时对应的生产版本。 |
| TWS 构建号 | 排查 API 行为差异。 |
| 操作系统 | Windows、macOS、Linux 安装包不同。 |
| 安装目录 | 方便找到日志、配置和启动程序。 |
官方离线安装页会按操作系统提供 Windows、macOS 和 Linux 下载入口。下载时只需要选择自己的操作系统，不要把离线安装包和 TWS API 开发包混在一起。
IB Gateway Latest / Stable
Section titled “IB Gateway Latest / Stable”IB Gateway 官方下载页提供 Latest 和 Stable：
| 版本 | 说明 |
|---|---|
| Latest | 最新生产版本，包含较新的功能；不会自动更新，需要重装获取新版本。 |
| Stable | 更新频率更低，更偏稳定；同样不会自动更新，需要重装获取新版本。 |
服务器场景通常更重视稳定和可复现，所以可以先选择 Stable。如果官方新功能或修复对你很重要，再考虑 Latest。
IB Gateway 下载页还会按平台区分 Apple Silicon、Apple Intel、Windows、Linux X86_64 和 Linux ARM64。普通云服务器多数是 Linux (X86_64)；ARM 服务器才选 ARM64。
IB Gateway 和 TWS 的 API 能力通常非常接近。官方教程也说明，API 应用既可以连接 TWS，也可以连接 IB Gateway。差别更多体现在界面和运维方式：TWS 更适合人看，IB Gateway 更适合后台跑。
对 API 开发有什么影响
Section titled “对 API 开发有什么影响”版本选择会影响：
- API 设置页面位置是否略有不同。
- 风险提示和登录流程是否变化。
- 某些新字段或新接口是否可用。
- 服务器自动化脚本是否需要调整。
- 日志位置、启动方式和版本目录是否变化。
所以阅读文档时，要允许界面随版本略有变化。只要菜单位置、字段含义和 API 设置一致，就不必因为按钮样式不同而重新安装。
推荐版本策略
Section titled “推荐版本策略”| 阶段 | 建议 |
|---|---|
| 刚学习 | 用官方推荐的 TWS 入口，先跑通连接。 |
| 写文档或做教程 | 用 TWS，记录版本日期。 |
| 排查线上问题 | 尽量固定版本，避免边排查边自动变化。 |
| 服务器模拟账户 | IB Gateway Stable 起步，确认功能不缺再考虑 Latest。 |
| 需要新功能 | 升级前先在模拟账户验证连接、行情、订单和错误处理。 |
不要混淆两个版本概念
Section titled “不要混淆两个版本概念”TWS / IB Gateway 的版本，和 TWS API Python 包版本不是同一件事。
| 项目 | 说明 |
|---|---|
| TWS / IB Gateway 版本 | 运行在桌面或服务器上的客户端版本。 |
| TWS API 包版本 | Python / Java / C++ / C# 开发包版本。 |
通常建议二者保持相对接近。不要长期使用很旧的 TWS / Gateway，却安装很新的 API 包；也不要反过来。
如果出现“旧代码突然行为不同”，排查时要同时记录：
- TWS / IB Gateway 版本。
- TWS API 包版本。
- 账户环境是 Paper 还是 Live。
- 连接端口和
clientId。 - 错误码和回调日志。
版本选择以官方下载页文字为准。读者只要理解 Latest、Stable、Offline Installer 的区别，再结合自己的开发或部署场景选择即可。