多语言 docker 环境需按场景配置：android 测试用 pro 镜像+emulator_language/country 环境变量；symfony/php 应用依赖 app_locale 和 php-intl 扩展；ai 服务重在 utf-8 编码与模型路径配置，统一使用小写语言短码。
多语言环境的 Docker 搭建，核心是让容器内系统或应用能正确识别、渲染并处理目标语言（如中文、日语、阿拉伯语等），同时兼顾可复用性、自动化和测试友好性。实际配置方式取决于你跑的是什么服务：是 Android 模拟器做 UI 本地化测试？是 PHP/Symfony 应用做后端翻译？还是大模型语音/文本服务支持多语种？下面分三类主流场景说明关键配置点。
Android 多语言测试环境（Docker-Android Pro）
适合 App 国际化 UI 测试，无需重启即可切换系统语言：
- 使用 Pro 版镜像（如
budtmo2/docker-android-pro:emulator_14.0），社区版不支持动态语言配置 - 通过环境变量指定语言和地区：
-e EMULATOR_LANGUAGE="zh"（ISO 639-1）-e EMULATOR_COUNTRY="CN"（ISO 3166-1）
组合效果等同于系统设置里的“中文（简体，中国）” - 启动时挂载 KVM 设备提升性能：
--device /dev/kvm - 加
-e WEB_VNC=true可通过浏览器http://localhost:6080实时查看界面语言效果
Symfony/PHP 类 Web 应用多语言环境
重点在运行时加载对应语言包，而非修改操作系统 locale：
- 在
docker-compose.yml中为 PHP 容器设置环境变量：APP_LOCALE: "fr"或TRANSLATION_LOCALES: "en,fr,es" - 确保翻译文件（YAML/XLIFF/JSON）按规范路径存放，例如：
translations/messages+intl-icu.fr.xlf - PHP 容器需安装
php-intl扩展（Alpine 下用apk add php82-intl） - 若需系统级 locale 支持（如日期格式化），可在 Dockerfile 中添加：
RUN apk add --no-cache tzdata && cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
AI 模型服务（ASR/TTS/LLM）多语言支持
这类服务通常靠模型权重和 tokenizer 内置多语能力，Docker 层只需保证编码与依赖兼容：
- 基础镜像建议用
python:3.10-slim或带 CUDA 的nvidia/cuda:12.1-base-ubuntu22.04 - 安装时显式指定 Unicode 支持：
ENV LANG=C.UTF-8ENV LC_ALL=C.UTF-8 - 对于中文 LLM（如 Qwen、Llama 3 中文版），确认 tokenizer 能正确分词中文，必要时挂载
/app/models并设MODEL_PATH环境变量 - 语音类服务（XTTS-v2、Qwen3-ASR）建议启用
gunicorn或uvicorn的--proxy-headers，方便前端传Accept-Language头控制响应语言
不复杂但容易忽略：所有多语言容器都应避免硬编码 locale 到镜像层，优先用 ENV + 运行时参数；语言代码统一用小写短码（zh、ja）或标准组合（zh-CN），避免混用 zh_Hans 这类非 Android/i18n 通用格式。
