Docker Windows容器添加Arial字体失败：PowerShell命令执行报错

问题原因 #

Dockerfile中RUN指令在Windows镜像环境下默认使用cmd.exe执行命令，而非PowerShell。你编写的字体注册命令是PowerShell语法，直接用cmd解析时会将(TrueType)这类PowerShell语法元素误判为命令参数，导致报错。而手动进入容器时是直接在PowerShell环境中执行，语法解析正常，所以命令能生效。

解决方案 #

方案1：明确指定用PowerShell执行命令 #

在RUN指令前添加powershell -Command，同时正确处理引号转义，避免cmd解析错误：

# 复制字体文件到容器
COPY Resources/fonts/ /windows/fonts/
# 用PowerShell执行字体注册命令，注意引号转义
RUN powershell -Command "New-ItemProperty -Path 'HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Fonts' -Name 'Arial (TrueType)' -PropertyType String -Value 'arial.ttf'"

或者使用双引号转义写法：

RUN powershell -Command "New-ItemProperty -Path \"HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Fonts\" -Name \"Arial (TrueType)\" -PropertyType String -Value \"arial.ttf\""

方案2：使用PowerShell脚本执行 #

将注册字体的逻辑保存为独立的.ps1脚本，避免在Dockerfile中处理复杂的引号转义：

1. 本地创建install-fonts.ps1文件，内容如下：

New-ItemProperty -Path "HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Fonts" -Name "Arial (TrueType)" -PropertyType String -Value "arial.ttf"

2. 修改Dockerfile：

COPY Resources/fonts/ /windows/fonts/
COPY install-fonts.ps1 /temp/
# 临时绕过执行策略并运行脚本
RUN powershell -Command "Set-ExecutionPolicy Bypass -Scope Process -Force; .\temp\install-fonts.ps1"

内容的提问来源于stack exchange，提问作者Cerveser