容器内服务能启动，宿主机却打不开，常见原因是没有建立端口转发，或者浏览器使用了容器端口而不是实际分配的本地地址。先确认服务进程确实存在，再通过 Dev Containers 转发该端口，并使用面板提供的地址访问。仅写 Dockerfile 的 EXPOSE 并不等于已建立宿主机访问入口。

VS Code 官方地址：https://code.visualstudio.com/

下面准备一个独立演示目录，用 Python HTTP 服务提供一页静态内容。前提是已安装 VS Code、Dev Containers 扩展且 Docker 可用。操作采用“准备文件、配置端口、打开结果”的方式；不导入真实业务数据，也不需要下载第三方页面素材。

1. 准备配置文件并重新进入容器

在 VS Code 使用 File → Open Folder 打开空的演示目录，在 Explorer 新建 .devcontainer/devcontainer.json，填写以下严格 JSON：

{
  "name": "Port demo",
  "image": "python:3.13-slim",
  "forwardPorts": [8000]
}

name 是演示环境名称，image 选用带 Python 的基础镜像，forwardPorts 声明连接容器时要转发的容器端口。JSON 不支持注释，因此字段说明放在这里。不要覆盖业务项目已经存在的整份配置；已有配置只合并端口项。

同一目录再新建 index.html，内容如下：

Port demo
这是开发容器里的静态页面。

保存文件后按 F1，执行 Dev Containers: Reopen in Container。等待镜像拉取和容器连接结束；成功状态是左下角显示容器连接信息，同时 Explorer 仍能看到刚才的文件。若 Docker 连接失败，先解决容器启动问题，端口转发不能替代容器启动。

2. 启动示例服务并添加转发端口

确认当前窗口已连接容器，通过 Terminal → New Terminal 打开容器终端，在包含 index.html 的工作区目录运行：

# 用容器内回环地址启动开发服务，终端需保持运行
python -m http.server 8000 --bind 127.0.0.1

这条命令面向读者复现，本文没有在本机执行或拍摄运行结果。服务只提供当前目录，请在专用演示目录运行，不要把凭据目录当作站点根目录。看到监听提示后，打开底部 PORTS / 端口 面板；找不到时可按 F1 搜索 Forward a Port。如果已有 8000 行，无需重复添加；否则输入容器端口 8000 确认。

成功状态是端口列表出现 8000，并提供对应的 Forwarded Address。这里输入的是容器端口，而不是随便挑一个宿主机端口。forwardPorts 只建立访问通道，不会自动运行 Python 服务。

3. 复制本地地址打开服务

在 PORTS → 8000 对应行 → Open in Browser 打开页面，或者复制这一行的 Forwarded Address 到宿主机浏览器。不要默认本地一定是 8000：端口冲突等情况可能导致转发到其他本地端口。以面板显示的地址为准，并使用 HTTP 协议访问本示例。

成功状态是页面显示 Port demo 标题和中文说明。如果得到目录列表，检查终端当前目录是否包含 index.html；如果访问了另一个应用，重新复制本地地址，排除浏览器沿用旧端口。转发条目存在但连接被拒绝时，应回到服务终端检查进程是否退出、端口是否与 8000 一致。

为什么不直接把监听地址改成 0.0.0.0

Dev Containers 的转发与 Docker 发布端口是两种访问机制。前者可以连接容器内 localhost 上的服务，本例因此绑定 127.0.0.1。若采用 Docker 的 ports 发布机制，服务只绑定容器回环地址通常无法通过发布端口访问，此时才需要根据应用情况调整监听地址和发布映射。不要一边改转发、一边改发布规则，最后无法判断生效的是哪条路径。

怎样保留示例，又怎样撤销它

将 .devcontainer/devcontainer.json 和演示页面加入自己的项目版本管理后，其他开发者可按相同步骤进入容器并启动服务。forwardPorts 修改后重新加载或重新打开容器窗口使配置应用；改镜像等容器构建配置时，应使用 Dev Containers: Rebuild Container。这个示例没有配置自动启动，重新进入容器后仍要手动启动 HTTP 服务。

临时撤销时，在端口行选择停止转发，并在服务终端按 Ctrl+C。长期撤销则从 forwardPorts 数组移除 8000 后重新连接。不要把“停止转发”等同于“服务已停止”；也不要为本地预览随意开放公网端口。

官方操作说明：https://code.visualstudio.com/docs/devcontainers/containers；配置创建说明：https://code.visualstudio.com/docs/devcontainers/create-dev-container。