只想用现成图形程序
走官方安装器，装 Designer/Terminal/Hydra 即可。
Routes
三种安装路径对照
按你的使用场景选择安装方式。
| 方式 | 适用 | 前置条件 | 说明 |
|---|---|---|---|
| 官方安装器（Installer） | 装 Designer / Terminal / Hydra / Shell 图形程序 | Windows 桌面环境 | 下载安装器，按向导安装与更新组件 |
| NuGet 包 | 用 API 写 C# 交易机器人 | Visual Studio + .NET SDK | 在项目里引入 StockSharp NuGet 包 |
| 源码编译 | 深度定制或参与开发 | .NET SDK + Git | clone 仓库后自行编译，注意自定义开源协议 |
Steps
通用安装步骤
- 准备 .NET 环境
用 API/NuGet/源码编译需先安装 .NET SDK；只用图形程序可先装官方安装器。
- 下载安装器或引入 NuGet
图形程序走官方安装器；写代码在 Visual Studio 项目里添加 StockSharp NuGet 包。
- 安装/还原依赖
安装器按向导完成；NuGet 自动还原依赖。
- 验证安装
启动 Designer/Terminal/Hydra，或编译一个最小 API 示例确认引用成功。
Scenarios
谁适合哪种方式
要写 C# 策略
用 NuGet 在 Visual Studio 里引入 API 库。
要深度定制
clone 源码自行编译，但需注意开源协议条款。
Alternative route
不想自己装 .NET 环境？
StockSharp 需要 C#/.NET 环境与连接器配置；如果你只是想做量化研究、拉行情或选股，免部署技能提供一句话提问路线。
Environment checklist
装之前先确认：环境与许可的 5 个前提
官方文档没有一页把这些前提集中列出来，但它们决定了你装完能不能真的跑起来。
| 前提 | 官方现状 | 不满足会怎样 |
|---|---|---|
| .NET / SDK 版本 | README 未注明具体版本号；仓库解决方案文件使用 .slnx 新版格式 | 用源码编译时可能直接构建失败，需较新的 Visual Studio / .NET SDK |
| 桌面环境 | Designer / Terminal / Hydra 都是桌面图形程序 | 无桌面的服务器环境无法直接运行图形端，只能走 API 路线 |
| Visual Studio（仅 API 路线） | 官方描述 API 面向使用 Visual Studio 的 C# 开发者 | 缺 IDE 会显著影响调试与策略开发效率 |
| 券商 / 数据源账号 | 连接器需要券商或数据源侧权限，部分需单独申请 API | 装完也无法验证连接，图形端只能空转 |
| 许可确认 | 自定义 notice（替代 Apache），GitHub 许可字段为 NOASSERTION / Other | 直接商用或二次分发前未读许可原文会有合规风险 |
上表依据仓库 README、官方文档与产品页当前记载（2026-09 核验）；官方未明确的项本站不代为推断，以官方下载页与许可文件为准。
Troubleshooting
首次运行的 5 个常见卡点与排查方向
这五类问题在社区提问里出现频率最高。下表给的是排查方向而非具体报错码，因为同一现象在不同连接器上的原因并不一样。
| 卡点 | 典型现象 | 排查方向 | 适用场景 / 注意点 |
|---|---|---|---|
| 安装包被拦截 | 安装器无法运行或被安全软件阻断 | 确认下载来源是官方下载页，再按系统提示放行 | 始终从官方渠道下载；以官方安装包与系统策略为准 |
| 连接器连不上 | 状态长时间未连接、收不到行情 | 检查券商是否已开通 API 权限、凭证是否正确、是否需本地网关 | MT4/MT5 类连接器通常需本地终端配合 |
| Hydra 下载无数据 | 任务执行完但没有产生任何数据 | 确认数据源订阅权限、市场范围与时间区间是否在可下载范围内 | 部分数据源对历史深度有限制 |
| 回测跑不出结果 | 策略执行完没有成交或指标为空 | 确认标的存在、数据区间正确、周期设置与数据粒度匹配 | 回测依赖本地已有历史数据 |
| 图表一片空白 | Terminal 打开后没有 K 线 | 确认行情订阅已建立且连接处于活动状态 | 实时图表依赖行情推送权限 |
排查顺序建议：先确认连接状态，再确认数据权限，最后才怀疑策略代码——顺序倒过来往往白花时间。具体报错信息以官方文档与对应连接器说明为准。
Installation verification
安装路径的可复现验收项
以下把安装“完成”定义为可留证据的状态，而非安装器显示成功。实际命令与支持版本应按当前官方安装说明补齐后再作为实测发布。
| 路径 | 验证动作 | 预期证据 | 限制 / 注意点 |
|---|---|---|---|
| 官方 Installer | 记录安装包来源与文件版本，按向导选择组件并启动目标应用 | 安装日志/版本信息及 Designer、Terminal 或 Hydra 启动记录 | 本文未在干净 Windows 环境实测；以官方安装器要求为准 |
| NuGet API | 固定 StockSharp 包版本，执行 restore 与 build | 依赖锁定记录、构建退出码和包版本 | 目标框架与包名需先由当前官方文档核实 |
| 源码编译 | 记录仓库 commit、SDK 与 IDE 版本，再依官方构建说明构建 | commit hash、构建日志和产物路径 | 不能从 README 未写明的环境版本自行推断兼容性 |
| 数据连接 | 先用模拟/只读环境检查连接、订阅与时间戳 | 脱敏日志、数据条数、首末时间 | 安装成功不等于拥有行情权限或下单权限 |
| 许可核对 | 保存所用版本的许可文件并审查分发/商用条款 | 许可文件快照与审查记录 | 仓库 license 元数据不是法律结论 |
| 回滚准备 | 保存可恢复的安装包/包版本与配置副本 | 恢复步骤和版本号可追溯 | 凭证单独管理，不将 API Key 放入日志或代码仓库 |
当前页面为官方路径整理与验收规范，未提供本站成功安装日志、截图或固定的 .NET/Visual Studio 版本矩阵。
Rollback plan
StockSharp 装坏了怎么退回去：升级前的回滚准备
StockSharp 的组件会随上游接口变化，升级后策略行为变化并不罕见。升级前把回滚条件写清楚，比事后排查省时间。
| 准备项 | 怎么做 | 失败时的处置 | 注意点 |
|---|---|---|---|
| 记录当前版本 | 保存安装包版本号、NuGet 包版本或仓库 commit | 按原版本重新安装/还原 | 只记「最新版」等于没有记录 |
| 备份配置 | 复制连接配置与策略文件（不含明文密钥） | 恢复配置后重新验证连接 | 凭证单独管理，不能写进策略仓库 |
| 备份本地数据 | 给 Hydra 数据目录做快照或确认可重新下载 | 数据可重建则无需回滚数据 | 部分数据源历史深度有限，未必能重下 |
| 锁定依赖版本 | 对 API 路线固定包版本，避免自动升级 | 回退到锁定版本即可复现 | StockSharp 未承诺 API 跨版本完全兼容 |
| 升级后最小验证 | 启动组件 → 连通数据源 → 跑一个已知策略 | 任一步失败即回滚，不继续往下改 | 先在非生产环境验证 |
| 记录升级结论 | 写下版本、日期、变化点与未验证项 | 作为下次升级的基线 | 本站尚未完成该流程的实机验证 |
回滚步骤属于运维建议，不是 StockSharp 官方流程；安装与升级方式请以官方下载页与文档为准。
FAQ
常见问题
StockSharp 有 pip/一键安装吗？
没有。它是 C#/.NET 平台，图形程序走官方安装器，API 走 NuGet，没有 pip 或「一键部署」命令。
装 StockSharp 需要什么前置？
图形程序需要 Windows 环境；API/源码需要 .NET SDK 与 Visual Studio（或等价编辑器）。
StockSharp 开源协议是什么？
仓库显示为自定义 notice（替代 Apache）。商用或二次分发前应阅读仓库 LICENSE 与条款。
能用 Python 吗？
主语言是 C#，官方提供 F# 与 Python 示例，但核心 API 是 .NET 生态。
能在 Linux 或 macOS 上装吗？
README 未明确列出操作系统支持范围，而 Designer / Terminal / Hydra 是桌面图形程序。实际选择时以官方下载页提供的安装包为准；无桌面的服务器环境通常只适合走 API（C#/.NET）路线。以官方说明为准。
装完为什么一点数据都没有？
多数情况不是安装失败，而是数据权限或连接没打通：连接器未配置、券商侧未开通 API、订阅的市场与时间区间超出可下载范围。按「连接状态 → 数据权限 → 策略代码」的顺序排查。具体限制以对应连接器与数据源说明为准。