# 排查GitHub Codespaces 的端口转发问题

常见端口转发问题的疑难解答步骤。

在 codespace 内运行的应用程序向控制台输出端口时，GitHub Codespaces 将检测到 localhost URL 模式并自动转发端口。 有关详细信息，请参阅“[代码空间中的转发端口](/zh/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace)”。

如果端口未自动转发，则可以手动转发该端口。 有关详细信息，请参阅“[代码空间中的转发端口](/zh/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace#forwarding-a-port)”。

如果设置了端口转发，请检查以下各项：

* 使用 VS Code 右下角弹出的通知“toast”消息中的链接，或单击终端中的 URL 打开转发端口。 如果通过浏览器连接到 codespace，则在本地计算机上键入 `localhost:8000`（作为示例）将不起作用。
* 确保在开发环境中检查您的应用程序是否仍在运行。 如果代码空间在一段时间不活动后停止，则需要确保在代码空间重新启动后重新启动应用程序。

通常，可使转发端口可公开访问，也可在拥有存储库的组织内访问。 有关详细信息，请参阅“[代码空间中的转发端口](/zh/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace)”。 如果公共或组织可见性选项中的任何一个或两者都不可用，则表示已配置了组织级别的策略。 有关详细信息，请参阅“[限制转发端口的可见性](/zh/codespaces/managing-codespaces-for-your-organization/restricting-the-visibility-of-forwarded-ports)”。

用于端口转发的域 GitHub 可能会不时更改。 如果在代码中引用转发的端口（例如在测试中），建议使用环境变量，而不是对 URL 进行硬编码。 有关详细信息，请参阅“[代码空间的默认环境变量](/zh/codespaces/developing-in-codespaces/default-environment-variables-for-your-codespace#list-of-default-environment-variables)”。