nimlang/nim

Nim Docker镜像文档

1. 镜像概述和主要用途

Nim是一种静态类型的命令式编程语言，旨在为开发者提供极致的控制力，同时不妥协运行时效率。其核心特点包括：基于中缀/缩进的简洁语法、强大的（基于AST的、卫生的）宏系统、支持线程本地堆的软实时垃圾回收（GC）、线程间异步消息传递（无"stop the world"机制），以及可选的不安全共享内存堆（用于提升效率）。Nim语言兼具C的效率、Lisp的表达力和Python的优雅。

本Docker镜像提供Nim语言的编译和运行环境，支持多版本、多基础镜像及多风味配置，适用于Nim项目的开发、编译和部署场景，简化环境一致性管理。

2. 核心功能和特性

2.1 多版本与标签体系

镜像标签由Nim版本、基础镜像和风味三部分构成，格式为nimlang/nim:[版本]-[基础镜像]-[风味]。默认规则如下：

• 版本：指定Nim版本（如2.2.2），latest对应最新稳定版；
• 基础镜像：默认使用Ubuntu，可选Alpine；
• 风味：默认使用regular（含Nimble包管理器），可选slim（仅含编译器）。

标签简化示例（以Nim 2.2.2为例）：

• nimlang/nim = nimlang/nim:latest = nimlang/nim:2.2.2 = nimlang/nim:2.2.2-ubuntu-regular
• 省略默认基础镜像：nimlang/nim:2.2.2-regular
• 省略默认风味：nimlang/nim:2.2.2-ubuntu

2.2 基础镜像支持

提供两种基础镜像：

• Ubuntu：默认基础镜像，兼容性好，适合大多数场景；
• Alpine：轻量级基础镜像，适合构建最小化部署包。

注：nimlang/choosenim镜像（用于Nim版本管理）基于bitnami/minideb。

2.3 风味（Flavors）

镜像分两种风味：

• regular（默认）：包含Nim编译器和https://github.com/nim-lang/nimble；
• slim：仅包含Nim编译器，体积更小。

3. 使用场景和适用范围

• 开发环境：快速搭建标准化Nim开发环境，避免本地依赖冲突；
• 项目编译：编译单个Nim文件或静态可执行文件（尤其适合Alpine基础镜像）；
• 多版本管理：通过nimlang/choosenim镜像管理多个Nim版本（含开发分支）；
• CI/CD集成：在自动化流程中嵌入Nim编译步骤，确保环境一致性。

4. 详细使用方法和配置说明

4.1 标签说明

4.2 获取镜像

获取最新稳定版（默认Ubuntu+regular）

shell
docker pull docker.xuanyuan.run/nimlang/nim

获取版本管理工具镜像

shell
docker pull docker.xuanyuan.run/nimlang/choosenim

4.3 编译单个Nim文件

通过挂载本地目录到容器，在容器内编译并运行Nim文件：

shell
docker run --rm -v $(pwd):/usr/src/app -w /usr/src/app docker.xuanyuan.run/nimlang/nim nim c -r myapp.nim

• --rm：编译完成后自动删除容器；
• -v $(pwd):/usr/src/app：挂载当前目录到容器内/usr/src/app；
• -w /usr/src/app：设置工作目录为挂载目录；
• nim c -r：编译并运行myapp.nim。

4.4 编译静态可执行文件

使用Alpine基础镜像编译静态链接的可执行文件（依赖少、可移植性强）：

shell
docker run --rm -v $(pwd):/usr/src/app -w /usr/src/app docker.xuanyuan.run/nimlang/nim:alpine nim c --passL:"-static -no-pie" myapp.nim

• --passL:"-static -no-pie"：向链接器传递静态编译参数。

5. 相关资源

• Nim官方网站
• Nim教程
• Nim文档
• https://github.com/nim-lang/docker-images/issues/new
• https://github.com/nim-lang/choosenim