n8n-guide/docs/installation/localization.md

# n8n汉化

## 📚 学习资源

- **汉化教程**：[n8n汉化指南](https://zhuanlan.zhihu.com/p/1937586953865372387)
- **官方文档**：[n8n官方文档](https://docs.n8n.io)
- **中文文档**：[n8n中文文档](https://docs.n8ncn.io)

在使用Docker部署时，可以通过添加环境变量的方式实现界面汉化。

## 🌏 汉化的必要性

### 为什么需要汉化

<div class="feature-grid">
  <div class="feature-card">
    <div class="feature-icon">👥</div>
    <h3>团队协作</h3>
    <p>降低团队成员的学习门槛，提高工作效率</p>
  </div>
  
  <div class="feature-card">
    <div class="feature-icon">📖</div>
    <h3>理解准确</h3>
    <p>避免因语言理解偏差导致的配置错误</p>
  </div>
  
  <div class="feature-card">
    <div class="feature-icon">🎯</div>
    <h3>专注业务</h3>
    <p>减少语言障碍，专注于业务逻辑设计</p>
  </div>
  
  <div class="feature-card">
    <div class="feature-icon">🚀</div>
    <h3>快速上手</h3>
    <p>新用户能更快熟悉界面和功能</p>
  </div>
</div>

## 🐳 Docker部署汉化方案

### 环境变量汉化

最简单的汉化方式是通过环境变量设置：

```yaml title="docker-compose.yml"
version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      # 基础配置
      - GENERIC_TIMEZONE=Asia/Shanghai
      - N8N_DEFAULT_LOCALE=zh-CN
      - N8N_DEFAULT_BINARY_DATA_MODE=filesystem
      
      # 界面汉化
      - LOCALE=zh-CN
      - LC_ALL=zh_CN.UTF-8
      - LANG=zh_CN.UTF-8
      
      # 认证配置
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=your-password
    volumes:
      - n8n_data:/home/node/.n8n
      - /data/n8n/files:/files

volumes:
  n8n_data:
```



## 🎨 界面汉化效果

### 汉化前后对比

| 功能区域 | 英文原版 | 中文汉化 |
|----------|----------|----------|
| **主菜单** | Workflows, Credentials, Executions | 工作流, 凭证, 执行历史 |
| **节点类型** | Triggers, Inputs, Processes, Outputs | 触发器, 输入, 处理, 输出 |
| **操作按钮** | Execute, Save, Activate, Settings | 执行, 保存, 激活, 设置 |
| **状态信息** | Running, Success, Error, Waiting | 运行中, 成功, 错误, 等待中 |

### 汉化覆盖范围

✅ **已汉化内容**:
- 主界面菜单和导航
- 节点分类和常用节点名称
- 工作流操作按钮
- 错误提示信息
- 设置界面选项

⚠️ **部分汉化内容**:
- 某些第三方节点名称
- 高级配置选项
- 开发者相关功能

❌ **未汉化内容**:
- 社区节点描述
- 技术文档链接
- 日志详细信息

## 🔧 汉化问题排查

### 常见问题和解决方案

| 问题 | 症状 | 解决方案 |
|------|------|----------|
| **语言包未生效** | 界面仍显示英文 | 检查挂载路径和环境变量 |
| **部分乱码** | 某些文字显示异常 | 确认字符集设置为UTF-8 |
| **功能异常** | 汉化后功能出错 | 使用官方语言包版本 |

### 验证汉化是否成功

```bash
# 检查容器环境变量
docker exec n8n env | grep -E "(LANG|LOCALE)"

# 检查语言包文件
docker exec n8n ls -la /usr/local/lib/node_modules/n8n/dist/packages/editor-ui/dist/static/locales/

# 查看n8n日志
docker-compose logs n8n | grep -i locale
```

## 📚 参考资源

- **详细汉化教程**: [n8n完整汉化指南](https://zhuanlan.zhihu.com/p/1937586953865372387)
- **官方多语言支持**: [n8n Internationalization](https://docs.n8n.io/hosting/configuration/#internationalization)
- **社区汉化项目**: GitHub上的中文社区维护版本

---

通过汉化，您的团队可以更高效地使用n8n，减少语言障碍带来的学习成本。

[上一章：凭证管理](credentials.md){ .md-button } [下一章：常用节点](../learning/common-nodes.md){ .md-button .md-button--primary }