GitHub Codespaces 创建失败、连不上与额度用尽怎么处理

课程仓库或公司模板要求用 Codespaces 时，国内常见的第一屏不是编辑器，而是创建对话框转圈。点 Code，切到 Codespaces 标签，再点 Create codespace on main，状态会停在 Setting up your codespace，最后变成 We couldn't create your codespace。有的人能创建，一进浏览器版编辑器又弹出 Oh no, it looks like you are offline，终端里的 git pull 也跟着断。

创建失败、额度拦截、WebSocket 断开、端口权限，四件事的按钮不在同一页。创建在仓库的 Code 菜单，额度在 Settings 的 Billing and plans，机密在 Codespaces secrets，端口在编辑器的 Ports 面板。下面按这个顺序做。免费核心小时和存储额度会调整，以官方最新条款为准。

浏览器版、桌面版和预构建差在哪

github.dev 只是网页里改文件，没有终端，也不吃 Codespaces 额度。作业要求 devcontainer.json 时必须走 Codespaces，点错成按键盘上的点号打开，会以为环境坏了，其实容器根本没建。

从建不成到能打开终端：分步操作步骤

• 第一步：先把网络线路准备好。安装刺猬VPN，自定义用户名和密码即可匿名注册，不需要邮箱、也不需要手机号。免费节点永久免费、不限流量、不限速。全程 HTTPS+AES 加密。连上之后再打开 github.com，不要在创建进行到一半时才去连线路。
• 第二步：节点先选离你即将选择的机房近的地区。创建对话框里的 Region 若是 East US，线路也优先美国东岸，避免容器在美东、网页长连接绕一圈。
• 第三步：确认仓库页能完整打开，包括 Code 按钮。仓库列表都进不去时，先按 GitHub 访问速度 把网页打通，再创建，否则失败原因会混在一起。
• 第四步：Code，Codespaces，选分支，机器先用 2-core。第一次不要上 8-core。点 Create codespace on main 后让 Setting up your codespace 自己走完，中途刷新会留下一个停在失败状态的实例。
• 第五步：组织仓库若提示 Codespaces is not available，那是组织策略关了，不是你的线路。让管理员到组织的 Settings，Codespaces，Policies 里允许。个人私有仓库则先看自己的 Billing。
• 第六步：打开头像，Settings，Billing and plans，看 Spending limit。出现 You have exceeded your spending limit 时，把限额调高或等到额度周期刷新。具体核心小时以官方最新条款为准，不要靠反复点击创建去撞。
• 第七步：容器起来后先在终端执行 git status，能返回再装扩展。扩展市场打不开时另看 VS Code 扩展市场，不要在创建日志里找扩展的错。
• 第八步：需要对外演示时打开 Ports，把端口从 Private 改成你真正需要的可见范围。作业只给老师看时保持 Private，把链接发给协作者即可。改成 Public 前先确认仓库没有密钥。
• 第九步：用完点 Stop codespace，不要只关浏览器标签。默认空闲约三十分钟会停，但标签还开着时心跳可能让它一直计时。下次从 github.com/codespaces 列表里 Resume。

按提示原文排查

把状态栏或红字对上原因，再决定是换节点、改账单还是删掉失败实例。

• 停在 Setting up your codespace 超过十五分钟：多半是拉镜像或拉仓库中断。停掉这个实例，换一个美国节点后重新 Create，不要在同一个失败实例上连续 Resume。
• We couldn't create your codespace：点开创建日志。若红字在 devcontainer.json 的 build，那是配置错误，换线路无效。若日志停在网络下载，再考虑节点。
• You have exceeded your spending limit：账单限额，不是连接问题。到 Billing and plans 改 Spending limit，或删掉不用的 codespace 释放存储。
• Oh no, it looks like you are offline：浏览器到云端编辑器的长连接断了。保持线路不要切换节点，点 Reload。反复出现就把空闲超时调短，避免挂机重连。
• Codespaces is not available for this organization：组织未开放。个人设置里改不了。
• 端口转发的地址打不开：Ports 里该端口是 Private，你用的是没登录的浏览器。用同一 GitHub 账号打开转发链接，或临时改可见范围。
• 机密没有进环境变量：机密加在仓库 Settings 还是账号的 Codespaces secrets，名字要和 devcontainer 里引用的一致。改完必须 Rebuild container，只 Resume 不会注入新机密。
• 桌面版一直 Connecting：命令面板执行 Codespaces: Connect to Codespace，确认登录的是同一个 GitHub 账号。浏览器能开、桌面不能开时，先更新 VS Code 再连。

额度和机型怎么选

Codespaces 的计费在 GitHub，不在线路。线路只解决网页和长连接能不能维持。免费节点适合第一次把 2-core 建起来。每天挂着写作业时，时长套餐按周期计费，期间不限流量、不限速。刺猬VPN自身不对账号设速率上限，实际速度受本地网络和国际出口影响。实际可用性取决于当前网络环境。

停机、重建和换地区的顺序

失败实例不要叠着建。顺序固定为：先在 github.com/codespaces 把状态是 Failed 的停掉并 Delete，再改 Region 或机器类型，最后重新 Create。直接再点一次 Create，旧实例仍占存储，下一轮更容易撞上支出限额。

换地区等于换一台机器，未提交的改动若没推回仓库会丢。先在终端里提交并推送，再 Delete。机密更新后走命令面板的 Codespaces: Rebuild Container，而不是只刷新网页。预构建 Prebuild 失败时，仓库设置里的 Prebuilds 页面能看到日志，那和你本地线路无关。

iPhone 上的浏览器可以看仓库，但不适合当作日常开发端。需要客户端时，中国大陆区 App Store 不提供 VPN 类应用，在港区 App Store 搜索上架名「Hedge VPN」，步骤见 iOS 安装教程。手机只用来看创建是否成功即可，编译仍放在电脑。

和网页版 GitHub、扩展市场的分工

仓库页面、克隆和下载慢，先处理 GitHub 访问速度。Codespaces 已经进了编辑器，只是扩展搜不到，再看 VS Code 扩展市场。两边的域名不一样，不要用同一句「连不上」概括。

创建对话框能打开，说明 github.com 这条已经通了。随后的失败要么在容器构建，要么在编辑器的长连接。把线路固定在和 Region 接近的国家，创建过程中不要切换节点，否则 Setting up 会从中段直接失败。组织策略和支出限额这两页即使用最快的线路也绕不过去。

常见报错速查表

创建日志和本机命令对照

失败实例右侧的日志比弹窗更有用。前半段是拉仓库，出现克隆超时就换节点重建。中段是拉开发容器镜像，若镜像名报错，先核对配置文件里的镜像地址是否写错，再考虑线路。后段是生命周期脚本，安装依赖失败属于项目本身，换国家不会消失。

浏览器终端和桌面版连的是同一台机器。一边提交，另一边不要同时变基。释放额度时，以列表页状态变成已停止为准，只关编辑器窗口不算停机。存储仍会计入，直到你删除这台实例。仓库开了预构建时，创建框可以选预构建来跳过一段安装，但机密改过之后的第一次仍要完整重建。

机密不要写进容器配置文件。放到账号设置里的机密页，并限定只对这个仓库生效。换电脑登录同一个账号后，机密还在，不需要跟着线路走。线路中断只影响当前这次长连接，不会把已经停掉的磁盘删掉。下次恢复仍是原来的工作区，未推送的提交也还在，只要你没有点删除。

端口只给自己看时，转发地址必须在已登录的浏览器里打开。把链接贴到未登录的手机上，会看到仓库的登录墙，这不是端口没起来。需要给同学看演示，再把可见范围从私人改成只对组织或公开，演示结束改回去。公开端口不要挂着数据库管理页。机器类型从二核改到四核等于换新环境，未提交的修改同样要先推送。

同学把仓库设成私有之后，你的账号若没有被加为协作者，创建按钮会变成没有权限，这和线路无关。先让对方在仓库设置的协作者里加上你的用户名，接受邀请后再创建。邀请停在待接受时，反复点创建只会得到同一句拒绝。课堂组织账号和私人账号不是同一个，浏览器右上角先核对头像，登错账号时机密页也是空的。作业截止前至少留出一次完整重建的时间，镜像拉取失败时重来一遍往往要十几分钟，不要卡在最后五分钟才第一次点创建。

高频问答

• 问：免费账号能不能用？答：能，在 GitHub 给该账号类型的核心小时之内。超出后会出现支出限额提示，小时数以官方最新条款为准。
• 问：要不要一直开着？答：不要。写完就 Stop。只关标签可能继续计时，直到空闲超时。
• 问：和本地 VS Code 哪个省事？答：依赖复杂、不想配环境时用 Codespaces。只改文档用 github.dev，不要为此建容器。
• 问：机密写进仓库了怎么办？答：立刻轮换密钥，把文件从历史里去掉，再改到 Codespaces secrets。线路不能补救已经推上去的密钥。
• 问：可以换机房加速吗？答：可以在创建时选 Region，但未推送的修改要先推走。换区不是换 VPN 节点能代替的。
• 问：手机能写完作业吗？答：只能看状态。创建、终端和端口转发放在电脑浏览器或桌面版 VS Code。

把创建和长连接分开处理

GitHub Codespaces 创建失败，先看是 Setting up 中断、支出限额，还是组织没开放。连上之后再出现 offline，才是编辑器长连接。顺序是：线路固定，仓库页能开，2-core 创建，终端能跑 git status，用完 Stop。不要在失败实例上反复 Resume。

刺猬VPN 提供按域名和 IP 的智能分流，以及断线保护。注册用自定义用户名和密码，不需要邮箱和手机号，找回密码凭支付订单记录。目前支持支付宝、微信支付和 USDT（TRC20），以支付步骤中实际显示的选项为准。一个账号可多设备同时在线。GitHub 的额度和地区策略以官方最新条款为准，实际可用性取决于当前网络环境。