CodeSandbox 国内打不开？项目、预览与依赖安装指南
CodeSandbox 的编辑器、文件同步、运行环境、依赖安装和预览端口不是同一条链路。大陆用户可能仓库导入成功，却长期停在启动环境；也可能终端已有服务日志，Preview 仍空白或 WebSocket 断开。
先创建最小 Sandbox 或 Devbox，保存一个文件、运行简单服务并打开预览，再导入真实仓库。这样能区分浏览器长连接、远程容器、包源和项目代码问题。重要代码应另存 Git，公开 Sandbox 不得包含 Token 与生产环境变量。
编辑器、环境、依赖和预览分开检查
文件树反复重连
实时同步依赖长连接，未确认保存前先复制重要改动。
环境启动很久
可能是资源额度、镜像或启动任务，不等于编辑器页面故障。
npm 安装超时
命令在远程环境执行，不继承本地浏览器线路，应看终端错误。
Preview 空白
检查进程监听地址、端口、构建错误和 WebSocket，而非只刷新 iframe。
用最小项目验证完整运行链路
- 1
创建并保存文件
写入唯一标题，刷新后确认远程工作区已保存。
- 2
打开终端
运行版本查询与简单命令，确认容器在线。
- 3
安装一个小依赖
记录 registry、TLS 或解析错误，不同时增加多个包。
- 4
运行最小服务
监听平台要求的 host 与端口，查看启动日志。
- 5
打开公开预览
测试刷新、静态资源和 WebSocket，再导入大型项目。
远程环境有独立网络
忍者云改善浏览器到 CodeSandbox 的连接，但容器访问 npm、Git 或 API 使用平台侧出站，需要在终端单独诊断。
忍者云改善工作区连接，不控制远程容器
忍者云可改善 CodeSandbox 编辑器、实时同步、终端界面和 Preview 的跨境连接。固定节点可减少长连接重建。
线路不能增加计算额度、修复构建、开放错误端口、改变远程包源或处理 Git 权限。部署与团队权限也由账户方案决定。
可改善
编辑器、文件同步、终端界面、预览 iframe 和 WebSocket。
不能改变
容器额度、项目代码、包源、端口、Git 权限和套餐。
Ninja Cloud
先跑通最小工作区与预览
忍者云帮助稳定 CodeSandbox 编辑器与长连接；远程容器、依赖、端口和构建仍需项目内处理。
常见问题
编辑器能开，Preview 为什么空白？
检查服务是否成功启动、监听正确地址和端口，并查看构建日志与 WebSocket。
本地 npm 正常，Sandbox 为什么安装失败？
远程环境使用独立网络、Node 版本和配置，不继承本地线路。
反复重连时会丢代码吗？
未同步修改有风险，应复制重要内容并在恢复后刷新确认。
忍者云能增加 Devbox 资源吗？
不能。计算资源与额度由 CodeSandbox 套餐决定。