环境准备

开发者模式对系统环境有一定要求。在开启之前，请确认您的电脑满足以下条件，以避免出现兼容性问题或功能异常。

操作系统要求

WinCode 同时支持 ARM64 和 x64 架构。请确保您安装的是与电脑芯片匹配的版本（例如 Apple Silicon 的 Mac 应使用 ARM64 版本）。

网络要求

开发者模式的网络需求取决于您的使用方式：

基础模式（无需网关）：

• 首次开启时需要联网下载 Sidecar 本地依赖（约 200MB）。
• 下载完成后，如果 API 端点配置为本地地址，则后续使用可以离线运行。

网关模式：

• 需要确保 WinCode 所在设备可以访问网关服务的地址（局域网内通常无障碍）。
• 网关服务本身需要能够访问最终的 API 服务地址。

本地 API 端点模式：

• 确保 WinCode 可以访问您配置的 API 地址。
• 如果 API 部署在内网，需要对应的网络连通性。

磁盘空间

开发者模式需要额外的磁盘空间用于存储本地依赖组件：

建议在系统盘（通常是 C 盘或 macOS 的 Macintosh HD）上预留至少 500MB 可用空间，以确保后续更新和缓存有足够的余量。

端口要求

如果您需要使用网关配对功能，请确保以下端口未被其他程序占用：

• 网关服务默认使用 8080 端口（可自定义）。
• WinCode 与网关之间的通信使用标准 HTTP/HTTPS 协议，无需额外开放端口。

在企业网络环境中，如果防火墙限制了端口访问，请联系网络管理员确认局域网内的通信是否被允许。

权限要求

• 首次开启：WinCode 需要写入应用数据目录以下载 Sidecar 组件。一般无需管理员权限，除非系统对应用数据目录做了特殊限制。
• 网关配对：如果网关运行在同一台电脑上，确保网关进程有权限监听对应端口。
• 本地 API：如果自建 API 服务，确保服务进程有权限绑定到指定端口。

快速自检清单

在开启开发者模式之前，请确认：

• 操作系统版本满足最低要求
• 已安装最新版本的 WinCode
• 系统盘有至少 500MB 可用空间
• 网络可以访问 WinCode 需要连接的网关或 API 地址
• 如有网关，网关服务已启动并可正常访问

全部确认后，您可以前往 开发者模式概览 了解如何开启。

相关文档

• 开发者模式概览
• 故障排查