docker容器中文乱码需同时配置locale与中文字体：在ubuntu/debian镜像中安装locales和fonts-noto-cjk，执行locale-gen生成zh_cn.utf-8，并设置env lang=zh_cn.utf-8 lc_all=zh_cn.utf-8；alpine则需musl-locales与font-noto-cjk。
VSCode 本身中文界面和 Docker 容器管理界面是两回事——前者由宿主机插件控制，后者（如终端输出、日志、调试器文本）完全取决于容器内部环境；装了中文语言包但没配好 locale 和字体，echo "你好" 依然显示 ??。
容器内终端中文乱码：必须在镜像里装 locale + 字体
基础镜像（如 python:3.11-slim、node:18-alpine）默认不带中文 locale 和字体。只改宿主机 VSCode 语言或装中文插件，对容器内 bash、python -c "print('测试')" 输出无效。
- Debian/Ubuntu 系镜像：在
Dockerfile中加
RUN apt-get update && apt-get install -y locales fonts-noto-cjk && \ sed -i '/zh_CN.UTF-8/s/^# //g' /etc/locale.gen && \ locale-gen ENV LANG=zh_CN.UTF-8 LC_ALL=zh_CN.UTF-8
- Alpine 镜像：用
musl-locales+font-noto-cjk -
locale -a | grep zh在容器内执行应有输出；locale应显示LANG=zh_CN.UTF-8 - 不生成 locale、只设 ENV 会失败——
locale-gen是必须步骤
Dev Container 中文插件要装在容器里，不是宿主机
Remote-Containers 模式下，VSCode 前端界面语言由宿主机决定，但所有插件运行时（终端、调试控制台、任务输出）都跑在容器进程里。菜单汉化了，pip list 输出仍是英文或乱码，说明问题出在容器侧。
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 在
.devcontainer/devcontainer.json中声明安装语言包：
"customizations": {
"vscode": {
"extensions": ["ms-ceintl.vscode-language-pack-zh-hans"]
}
}
- 必须执行
Remote-Containers: Rebuild and Reopen in Container，仅Developer: Reload Window不生效 - 插件安装后，容器内
/root/.vscode-server/extensions/下应有对应目录；若没有，说明没进容器环境安装
docker CLI 输出中文异常：检查宿主机 locale 设置
VSCode 的 Docker 扩展调用的是本地 docker 命令，如果 docker logs <container-id></container-id> 在终端里也乱码，问题不在容器，而在宿主机 shell 的 locale 配置。
- 运行
locale，确认LANG和LC_CTYPE是zh_CN.UTF-8或其他 UTF-8 locale - Linux/macOS：在
~/.bashrc或~/.zshrc加export LANG=zh_CN.UTF-8并source - Windows WSL2：确保 WSL 发行版内 locale 正确，且 VS Code 启动自该 shell（而非 Windows GUI 启动）
-
docker version输出含中文字符（如帮助文本）正常，才代表 CLI 层级已就绪
中文路径挂载失败或 Git 权限异常
用中文命名的项目目录挂进容器后，git status 报错或文件名显示为 ???，通常因挂载时编码协商失败或 UID/GID 不匹配。
- 避免在
devcontainer.json的mounts中使用含中文的绝对路径（尤其 Windows 主机 → WSL2 容器）；优先用英文路径中转 - 确保容器用户 UID 与宿主机一致：
"remoteUser": "vscode"+"runArgs": ["--user", "1001:1001"]（1001 替换为你宿主机用户的 UID） - Git 提交失败常见于挂载卷属主为
root，而容器内用户无写权限——用USER vscode显式切换用户比依赖remoteUser更可靠
真正卡住人的从来不是“怎么装插件”，而是 locale 生成漏了 locale-gen、字体没进容器、或者以为宿主机汉化了整个开发链路——实际只有终端那一层还裸着。每次 rebuild 容器前，先 docker run --rm -it your-image locale 和 ls /usr/share/fonts/ 确认两件事，比反复 reload window 省半小时。
