
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可:
请先阅读并遵守:https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
在Linux上开发C++应用程序。包含Debian C++构建工具。
| 元数据 | 值 |
|---|---|
| 类别 | 核心、编程语言 |
| 镜像类型 | Dockerfile |
| 已发布镜像 | mcr.microsoft.com/devcontainers/cpp |
| 可用镜像变体 | debian-12、debian-11、debian-10、ubuntu-24.04、ubuntu-22.04、ubuntu-20.04(完整列表) |
| 已发布镜像架构 | x86-64,以及适用于debian-12、debian-11、ubuntu-24.04和ubuntu-22.04变体的aarch64/arm64 |
| 容器主机OS支持 | Linux、macOS、Windows |
| 容器OS | Debian、Ubuntu |
| 支持的语言和平台 | C++ |
有关已发布镜像内容的信息,请参见**https://github.com/devcontainers/images/tree/main/src/cpp/history**。
vscode,具备sudo权限,符合开发安全最佳实践可通过在.devcontainer/devcontainer.json中设置image属性,或在自定义Dockerfile中更新FROM语句,直接引用预构建的Dockerfile版本。仓库中包含示例Dockerfile。
可用镜像标签:
mcr.microsoft.com/devcontainers/cpp(最新Debian GA版本)mcr.microsoft.com/devcontainers/cpp:debian(最新Debian GA版本)mcr.microsoft.com/devcontainers/cpp:debian-12(或bookworm)mcr.microsoft.com/devcontainers/cpp:debian-11(或bullseye)mcr.microsoft.com/devcontainers/cpp:debian-10(或buster)mcr.microsoft.com/devcontainers/cpp:ubuntu(最新Ubuntu LTS版本)mcr.microsoft.com/devcontainers/cpp:ubuntu-24.04(或noble)mcr.microsoft.com/devcontainers/cpp:ubuntu-22.04(或jammy)mcr.microsoft.com/devcontainers/cpp:ubuntu-20.04(或focal)更多详情请参考https://containers.dev/guide/dockerfile。
可通过引用镜像的https://semver.org/控制更新频率,例如:
mcr.microsoft.com/devcontainers/cpp:1-bookwormmcr.microsoft.com/devcontainers/cpp:1.0-bookwormmcr.microsoft.com/devcontainers/cpp:1.0.0-bookworm注意:我们仅对最新的https://github.com/devcontainers/images/issues/90镜像版本(如`0-debian-11`)进行安全补丁更新。如果锁定到更具体的版本,建议在Dockerfile中运行`apt-get update && apt-get upgrade`以获取OS安全更新。
有关每个版本内容的信息,请参见https://github.com/devcontainers/images/tree/main/src/cpp/history,完整标签列表。
如需完全自定义容器内容,或为镜像不支持的容器主机架构构建,可使用https://github.com/devcontainers/images/tree/main/src/cpp/.devcontainer中的内容。
此开发容器及其关联镜像包含Vcpkg仓库(用于库包)的克隆,以及Vcpkg-tool的引导实例。
CMake版本要求
Debian(<=11)和Ubuntu(<=21.10)的主软件仓库中提供的cmake版本低于安装包所需的最低版本。在此情况下,Vcpkg将为自身使用下载兼容版本的cmake(仅x86_64架构)。
库包来源与配置
使用Vcpkg安装的大多数额外库包将从其https://github.com/microsoft/vcpkg#security下载。如需配置容器中的Vcpkg以访问备用注册表,请参考:Registries: Bring your own libraries to vcpkg。
更新Vcpkg库包
要更新可用的库包,可在终端中运行以下命令从git仓库拉取最新内容:
shcd "${VCPKG_ROOT}" git pull --ff-only
注意:请查看https://github.com/microsoft/vcpkg#license,以了解其自身许可证以及与库包和支持端口相关的附加许可证信息。
dev container规范镜像由https://github.com/devcontainers/images仓库维护。可在该仓库中浏览各镜像并提交问题或功能请求。
版权所有 (c) Microsoft Corporation。保留所有权利。
根据MIT许可证授权。详见https://github.com/devcontainers/images/blob/main/LICENSE。
以下是 microsoft/devcontainers-cpp 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务