1. WPML (WordPress Multilingual Plugin) - 付费，功能最强

• 优点：功能完整，兼容性好，支持所有主题和插件
• 缺点：需要付费（$39+/年）
• 适合：商业网站，预算充足

2. Polylang - 免费，推荐

• 优点：免费，轻量，易用，兼容性好
• 缺点：高级功能需要付费
• 适合：个人网站，中小型项目

3. qTranslate-XT - 免费

• 优点：完全免费，简单易用
• 缺点：兼容性一般，更新不频繁
• 适合：简单的双语需求

4. Weglot - 付费，自动翻译

• 优点：自动翻译，无需手工维护
• 缺点：需要付费，翻译质量一般
• 适合：快速上线需求

🚀 推荐方案：Polylang + 手动配置

基于您的需求，我推荐使用 Polylang，理由：

• 免费且功能强大
• 支持中英文双语
• 兼容性好
• 社区活跃

📋 安装和配置步骤

步骤1：安装Polylang插件

方法A：通过WordPress后台安装（推荐）

1. 登录WordPress后台：http://localhost:8080/wp-admin
2. 进入 插件 → 安装插件
3. 搜索 “Polylang”
4. 安装并激活

方法B：手动下载安装

# 下载Polylang插件
cd /Users/heyaohua/Server/WordPress_Docker
docker exec wordpress_app bash -c "
cd /var/www/html/wp-content/plugins &&
wget https://downloads.wordpress.org/plugin/polylang.latest-stable.zip &&
unzip polylang.latest-stable.zip &&
rm polylang.latest-stable.zip
"

步骤2：配置语言

1. 激活插件后，进入 设置 → 语言
2. 添加语言：
3. 中文：中文 (zh_CN)
4. 英文：English (en_US)
5. 设置默认语言（推荐中文）
6. 选择URL结构：
7. 子目录：yoursite.com/zh/ 和 yoursite.com/en/（推荐）
8. 子域名：zh.yoursite.com 和 en.yoursite.com
9. 参数：yoursite.com/?lang=zh

步骤3：配置菜单和小工具

1. 创建菜单：
2. 进入 外观 → 菜单
3. 为每种语言创建单独的菜单

在菜单页面右上角选择语言

配置小工具：

6. 进入 外观 → 小工具
7. 为不同语言配置不同的小工具

步骤4：创建双语内容

1. 页面/文章：
2. 创建内容时选择语言
3. 使用"+“按钮创建其他语言版本

建立页面/文章之间的翻译关系

分类和标签：

6. 在分类/标签页面为每个分类创建翻译版本

🎨 主题优化

支持多语言的主题推荐

1. Astra（免费 + 付费）
2. OceanWP（免费 + 付费）
3. GeneratePress（免费 + 付费）
4. Twenty Twenty-Four（WordPress默认主题）

主题配置

// 在主题的functions.php中添加语言切换器
function add_language_switcher() {
    if (function_exists('pll_the_languages')) {
        echo '<div class="language-switcher">';
        pll_the_languages(array(
            'show_flags' => 1,
            'show_names' => 1,
            'display_names_as' => 'name'
        ));
        echo '</div>';
    }
}

🔧 高级配置

1. 自定义URL结构

在WordPress根目录的 .htaccess 文件中配置：

# Polylang URL重写规则
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /

# 中文页面
RewriteRule ^zh/(.*)$ /index.php?lang=zh&$1 [QSA,L]

# 英文页面
RewriteRule ^en/(.*)$ /index.php?lang=en&$1 [QSA,L]
</IfModule>

2. 语言检测和重定向

// 在functions.php中添加自动语言检测
function auto_language_redirect() {
    if (!is_admin() && function_exists('pll_current_language')) {
        $current_lang = pll_current_language();
        $browser_lang = substr($_SERVER['HTTP_ACCEPT_LANGUAGE'], 0, 2);

        if (empty($current_lang) && $browser_lang == 'en') {
            wp_redirect(home_url('/en/'));
            exit;
        } elseif (empty($current_lang)) {
            wp_redirect(home_url('/zh/'));
            exit;
        }
    }
}
add_action('template_redirect', 'auto_language_redirect');

3. SEO优化

安装Yoast SEO插件，与Polylang完全兼容：

# 安装Yoast SEO
docker exec wordpress_app bash -c "
cd /var/www/html/wp-content/plugins &&
wget https://downloads.wordpress.org/plugin/wordpress-seo.latest-stable.zip &&
unzip wordpress-seo.latest-stable.zip &&
rm wordpress-seo.latest-stable.zip
"

🌐 双语网站结构示例

网站首页
├── 中文版 (yoursite.com/zh/)
│   ├── 关于我们 (/zh/about/)
│   ├── 产品服务 (/zh/services/)
│   ├── 新闻动态 (/zh/news/)
│   └── 联系我们 (/zh/contact/)
├── 英文版 (yoursite.com/en/)
│   ├── About Us (/en/about/)
│   ├── Services (/en/services/)
│   ├── News (/en/news/)
│   └── Contact (/en/contact/)
└── 语言切换器（全站可见）

📱 移动端优化

1. 响应式设计：确保语言切换器在移动端正常显示
2. 性能优化：使用缓存插件（WP Rocket, W3 Total Cache）
3. 图片优化：使用WebP格式，配置CDN

🔒 安全考虑

1. 备份策略：多语言网站数据更复杂，定期备份
2. 插件更新：及时更新Polylang和相关插件
3. 权限管理：为不同语言版本设置合适的编辑权限

📊 常用代码片段

获取当前语言

$current_language = pll_current_language();
echo $current_language; // 输出: zh 或 en

获取页面翻译

$translations = pll_get_post_translations($post_id);
foreach ($translations as $lang => $post_id) {
    echo pll_get_post($post_id, $lang);
}

条件显示内容

if (pll_current_language() == 'zh') {
    echo '中文内容';
} elseif (pll_current_language() == 'en') {
    echo 'English Content';
}

语言切换菜单

// 显示旗帜和语言名称
pll_the_languages(array(
    'show_flags' => 1,
    'show_names' => 1,
    'hide_current' => 1
));

// 仅显示旗帜
pll_the_languages(array(
    'show_flags' => 1,
    'show_names' => 0
));

🛠️ 问题排查

常见问题

1. URL不正确：检查固定链接设置
2. 翻译丢失：重新建立翻译关联
3. SEO问题：配置hreflang标签
4. 性能问题：使用缓存插件

调试代码

// 调试当前语言信息
function debug_polylang_info() {
    if (function_exists('pll_current_language')) {
        echo '<div style="position:fixed;top:0;right:0;background:red;color:white;padding:10px;">';
        echo '当前语言: ' . pll_current_language() . '<br>';
        echo '默认语言: ' . pll_default_language() . '<br>';
        echo '所有语言: ' . implode(', ', pll_languages_list()) . '<br>';
        echo '</div>';
    }
}
add_action('wp_footer', 'debug_polylang_info');

📈 内容管理策略

1. 翻译工作流程

1. 创建中文内容（主语言）
2. 创建英文翻译页面
3. 建立翻译关联
4. 检查链接和菜单
5. SEO优化

2. 内容同步

• 使用翻译管理插件
• 建立内容更新检查清单
• 定期审核双语内容一致性

3. 团队协作

• 为翻译人员创建单独账户
• 设置语言特定的编辑权限
• 使用协作插件管理翻译进度

💡 下一步建议：

1. 先登录WordPress后台安装Polylang插件
2. 按照上述步骤配置中英文双语
3. 创建测试页面验证功能
4. 根据需要调整主题和样式

1. WPML (WordPress Multilingual Plugin) ⭐⭐⭐⭐⭐

• 类型：付费插件（$39-$159/年）
• 优点：
• 最完整的多语言解决方案
• 支持自动翻译和人工翻译
• 完美的URL结构（/en/, /cn/）
• 支持WooCommerce等插件
• 专业的翻译管理界面
• 缺点：
• 需要付费
• 功能较多，初学者可能觉得复杂

2. Polylang ⭐⭐⭐⭐

• 类型：免费版 + Pro版
• 优点：
• 免费版功能已经很强大
• 简单易用
• 支持自定义URL结构
• 与大多数主题兼容
• 缺点：
• 某些高级功能需要Pro版
• 需要手动配置较多

3. TranslatePress ⭐⭐⭐⭐

• 类型：免费版 + 付费版
• 优点：
• 可视化翻译界面
• 前端实时翻译
• 支持自动翻译（付费）
• SEO友好
• 缺点：
• 免费版功能有限
• 可能影响网站性能

4. Weglot ⭐⭐⭐

• 类型：付费服务（基于使用量）
• 优点：
• 自动翻译
• 云端管理
• 快速部署
• 缺点：
• 持续付费
• 依赖第三方服务

🎯 推荐的专业实施方案

基于您已经安装了Polylang，这里是完整的专业配置步骤：

步骤1：正确配置Polylang

进入WordPress后台 → 语言 → 设置

URL修改设置：

3. 选择：The language is set from the directory name in pretty permalinks

这会生成 /en/ 和 /cn/ 的URL结构

语言设置：

英语：

6. 语言代码：en
7. 区域设置：en_US
8. 语言顺序：1
9. URL中的语言：en（或留空作为默认）

中文：
- 语言代码：zh
- 区域设置：zh_CN
- 语言顺序：2
- URL中的语言：cn

1. 检测浏览器语言：
2. 勾选"检测浏览器语言"
3. 设置默认语言重定向

步骤2：内容管理最佳实践

1. 创建内容时：
2. 先创建一种语言的内容
3. 使用Polylang的"+“按钮创建翻译版本

保持URL slug的一致性

菜单管理：

6. 为每种语言创建独立菜单

在"外观 → 菜单"中切换语言编辑

小工具管理：

9. 使用Polylang的语言特定小工具
10. 或使用条件显示插件

步骤3：主题兼容性处理

// 在主题的 functions.php 中添加
// 确保主题完全兼容Polylang

// 1. 注册可翻译的字符串
if (function_exists('pll_register_string')) {
    pll_register_string('theme_read_more', 'Read More', 'Theme');
    pll_register_string('theme_search', 'Search', 'Theme');
}

// 2. 在主题中使用翻译
if (function_exists('pll__')) {
    $read_more_text = pll__('Read More');
} else {
    $read_more_text = __('Read More', 'textdomain');
}

// 3. 自定义语言切换器样式
function custom_language_switcher() {
    if (function_exists('pll_the_languages')) {
        echo '<ul class="language-switcher">';
        pll_the_languages(array(
            'show_flags' => 1,
            'show_names' => 1,
            'dropdown' => 0,
            'hide_current' => 0
        ));
        echo '</ul>';
    }
}

步骤4：SEO优化

1. 安装Yoast SEO + Polylang集成
2. 设置hreflang标签（Polylang自动处理）
3. 为每种语言优化元数据

步骤5：性能优化

1. 使用缓存插件（如WP Rocket）
2. 配置CDN支持多语言
3. 优化数据库查询

🚀 一键部署方案

如果您想要更简单的方案，可以考虑：

1. 使用多语言主题：
2. WPML Ready主题

Polylang兼容主题

使用托管服务：

5. WordPress.com商业版（内置多语言）

Kinsta等专业托管（预配置多语言）

使用现成的多语言模板：

8. ThemeForest上的多语言主题
9. 预配置好的Docker镜像

💡 为什么会"改来改去”？

您遇到的问题主要是因为：

1. 没有遵循插件的标准用法：每个插件都有自己的工作方式
2. 混合了不同的实现方法：手动代码和插件功能冲突
3. URL结构不一致：需要从一开始就规划好
4. 没有使用插件提供的API：直接修改可能破坏功能

✅ 建议的清理和重新配置

1. 备份当前网站
2. 清理所有自定义的多语言代码
3. 完全依赖Polylang的功能
4. 按照官方文档配置
5. 只在必要时添加兼容性代码

📚 官方资源

• Polylang官方文档
• WPML官方指南
• WordPress多语言最佳实践

🎯 最终建议

如果您需要一个稳定、专业、不需要经常修改的解决方案：

1. 小型网站：使用Polylang免费版，严格按照官方文档配置
2. 商业网站：投资WPML，获得完整的技术支持
3. 企业网站：考虑使用WordPress Multisite，每种语言一个子站

记住：不要重新发明轮子，使用成熟的解决方案并遵循最佳实践！

行内公式

当公式只需要嵌入在段落中时，可使用单个美元符号包裹表达式，例如 $E = mc^2$。这是著名的质能方程，适合在正文中快速引用。

块级公式

对于需要突出显示的公式，可使用双美元符号放在独立段落中：

一元二次方程求根

$$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$

欧拉恒等式

$$e^{i\pi} + 1 = 0$$

高斯积分

$$\int_{-\infty}^{\infty} e^{-x^2} , dx = \sqrt{\pi}$$

矩阵乘法

线性代数场景中，矩阵语法有助于展示多维运算：

$$ \begin{pmatrix} a & b
c & d \end{pmatrix} \begin{pmatrix} x
y \end{pmatrix}

\begin{pmatrix} ax + by
cx + dy \end{pmatrix} $$

求和公式

常见求和表达式也能通过 LaTeX 清晰呈现：

$$\sum_{i=1}^{n} i = \frac{n(n+1)}{2}$$

提示：撰写公式类文章时，务必确认 pelicanconf.py 中已启用 render_math 插件，并保持 LaTeX 语法正确，以确保静态页面渲染正常。

博客定位

• 分享 Python、数据工程、云原生等方向的技术文章
• 记录项目复盘与实战案例，整理可复用的解决方案
• 输出读书笔记、课程总结与工具心得
• 偶尔发布职业发展与个人效率提升的感悟

技术栈概览

• Pelican：静态站点生成器，负责内容构建与部署
• Markdown：文章撰写格式，方便版本管理与协作
• GitHub：代码与内容仓库，配合 CI/CD 完成持续部署
• ECS：线上运行环境，托管网站静态资源

内容规划

1. 技术专栏：包含源码解析、性能优化、系统设计等专题
2. 工程实践：记录在企业项目中的落地经验与踩坑总结
3. 学习札记：对前沿技术和优秀论文的阅读体会
4. 工具指南：分享常用开发工具、自动化脚本与效率技巧

联系方式

如有合作、讨论或建议，欢迎通过以下方式联系我：

• GitHub：https://github.com/heyaohua
• 邮箱：your-email@example.invalid

感谢你的关注，期待在这里与更多技术同好交流与成长。