PhotoCraft 怎么设置中文界面
PhotoCraft 官方版自带简体中文和繁體中文：在 编辑 › 首选项 › 界面 › 语言 中切换，无需重启。另附中文输入法、未翻译内容和翻译反馈说明。
PhotoCraft 官方安装包从 v0.3.0 起就自带简体中文和繁體中文，不需要额外下载汉化包。打开 编辑 › 首选项 › 界面…（Edit › Preferences › Interface…），在 语言（Language）里选 简体中文，点 应用 或 确定 即可。v0.5.0 起切换立即生效，不用重启，已打开的文档和历史记录都不受影响。注意：网页版（包括本站的在线编辑器）暂时只能使用英文界面，原因见下文“网页版”一节。
切换到简体中文
Windows 和 Linux
- 打开菜单 Edit › Preferences › Interface…。界面还是英文时，菜单就是这几个英文名，中文界面下对应 编辑 › 首选项 › 界面…。
- 在 Language（语言）下拉框中选择 简体中文。首选项对话框会先用中文预览自己的标题、控件和按钮。
- 点 Apply（应用）切换并保留对话框，或点 OK（确定）切换并关闭。点 Cancel（取消）则放弃预览。
切换后，主窗口在下一次重绘时就变成中文。设置会被保存，下次启动仍是中文。
macOS
v0.5.0 起，PhotoCraft 在 macOS 上改用系统原生菜单栏。应用菜单 PhotoCraft 里有 Language（语言）子菜单，直接选 简体中文 即可。上面的首选项方法在 macOS 上同样可用。
繁體中文
步骤相同，在语言列表里选 繁體中文。繁體界面使用台湾地区的常用词，例如 編輯 › 偏好設定 › 介面… › 語言。简体（zh-hans）和繁體（zh-hant）是两套独立的翻译。
网页版
网页版（包括本站的在线编辑器）暂时只能使用英文界面：它不会跟随浏览器语言，手动切换到简体中文、繁體中文、日文或韩文后，界面文字会显示成空白方框（#1615）。需要中文界面，请使用 Windows、macOS 或 Linux 桌面版。
自动跟随系统语言
没有手动选过语言时，设置为 自动（Auto）：PhotoCraft 按系统的首选界面语言挑选第一个受支持的语言。所以系统是中文的话，首次启动通常直接就是中文。
- Windows：读取 Windows 显示语言（按顺序），不看“区域”里的日期和数字格式。
- macOS：读取“系统设置”里的首选语言。
- Linux：读取
LANGUAGE、LANG、LC_*等语言环境变量。
zh、zh-CN、zh-SG、zh-Hans 会对应简体中文，zh-TW、zh-HK、zh-MO、zh-Hant 会对应繁體中文。都匹配不上时使用英文。手动选过的语言始终优先于“自动”。如果只是临时想用某种语言启动一次，可以设置环境变量，例如：
PHOTOCRAFT_LOCALE=zh-hans photocraft
支持哪些语言
截至 v0.6.0（2026 年 10 月），官方版共 17 种界面语言，列表中以各语言自己的名称显示：
| 语言 | 列表中显示为 | 代码 | 加入版本 |
|---|---|---|---|
| 英语 | English | en | v0.1.0 |
| 日语 | 日本語 | ja | v0.3.0 |
| 简体中文 | 简体中文 | zh-hans | v0.3.0 |
| 繁体中文 | 繁體中文 | zh-hant | v0.3.0 |
| 西班牙语 | Español | es | v0.3.0 |
| 俄语 | Русский | ru | v0.3.0 |
| 捷克语 | Čeština | cs | v0.3.0 |
| 法语 | Français | fr | v0.5.0 |
| 印尼语 | Bahasa Indonesia | id | v0.5.0 |
| 韩语 | 한국어 | ko | v0.5.0 |
| 德语 | Deutsch | de | v0.5.0 |
| 巴西葡萄牙语 | Português (Brasil) | pt-br | v0.5.0 |
| 意大利语 | Italiano | it | v0.5.0 |
| 乌克兰语 | Українська | uk | v0.6.0 |
| 波兰语 | Polski | pl | v0.6.0 |
| 希腊语 | Ελληνικά | el | v0.6.0 |
| 荷兰语 | Nederlands | nl | v0.6.0 |
v0.2.0 及更早的版本没有语言设置。如果你找不到这个选项，请先更新到最新版。
哪些内容仍是英文
简体中文翻译覆盖全部菜单、对话框、面板、混合模式名称和首选项标签，并有测试保证覆盖率。不过以下内容在所有语言下都保持英文：
- 引擎的错误信息和状态栏提示
- 自动化相关的输出和命令 ID（CLI、MCP、控制通道）
- 你自己输入的文档名、图层名和预设名
所以中文界面里偶尔弹出一句英文报错是正常的，不属于翻译遗漏。PhotoCraft、RGB、CMYK、OpenType 等产品名和技术名也会保留原文。
中文输入法和字体
- 输入法：v0.3.0 起，文字工具支持输入法（IME）输入，界面也能显示中日韩文字。
- 字体：中日韩字体的回退依赖系统里已安装的字体。如果中文显示成方框，请先通过系统安装一套中文字体。
- Ubuntu + fcitx5 无法输入中文（#451，已关闭）：v0.2.0 的问题，报告者确认 v0.3.0 已修复。若在某些 Wayland 合成器下仍无法输入，开发者建议先在 XWayland 下测试：
WAYLAND_DISPLAY= XMODIFIERS=@im=fcitx photocraft。在原生 Wayland 下使用输入法，需要合成器支持相应的输入法协议。 - Wayland 下按一次键却无限重复（#585，已关闭）：v0.5.0 已修复。
- Wayland 下用 Ctrl+A、Shift+方向键或鼠标选中文字后文字被删掉（#1381，已关闭）：v0.6.0 已修复。旧版本可以用
WAYLAND_DISPLAY= photocraft在 XWayland 下启动来避开。
更多 Linux 问题见故障排除指南。
发现翻译问题怎么办
简体中文翻译位于仓库的 crates/ui-egui/src/i18n/zh-hans.tsv，繁體中文位于同目录的 zh-hant.tsv。这是普通的 UTF-8 文本文件，每行三列：上下文、英文原文、译文。缺失的条目会显示英文。
- 翻译错误或用词别扭：在 GitHub Issues 提交问题（也可以用 帮助 › 报告问题…），写明英文原文、当前译文、出现位置和建议译法。直接提交修改 TSV 的 Pull Request 更好。
- 术语对照：
docs/localization-zh-hans.md列出了统一术语，例如 图层、蒙版、选区、羽化、智能对象、首选项。 - 参与翻译或新增语言：参见
docs/localization.md的 “Add or maintain a catalog” 一节。
翻译以项目的 MIT OR Apache-2.0 许可证贡献。
不需要下载“中文版”安装包
官方安装包里已经包含简体中文和繁體中文，不存在单独的“中文版”。网上流传的重新打包的“汉化版”安装包，例如 GitHub 上的第三方仓库 awpde/photocraft-zh，都不是 PhotoCraft 项目发布的。官方 Windows 安装包有代码签名，macOS 的 DMG 经过签名和公证，第三方构建无法用同样的方式核验来源，版本也可能落后于官方。请从官方 GitHub Releases 下载，再按上面的方法切换成中文。