ESP-IDF在线文档网站语言标识符跳转问题解析

问题现象

在ESP-IDF在线文档网站使用过程中，用户发现当切换芯片目标或版本选择时，会出现页面跳转异常的情况。具体表现为：URL中的语言标识符"zh_CN"被自动替换为"zh-CN"，导致页面无法正常显示，返回404错误。

问题分析

该问题主要出现在ESP-IDF的release-v5.3及之后的版本中。当用户从正常访问的页面（如esp32芯片文档页面）切换到其他芯片目标（如ESP32-S3）时，系统错误地将下划线格式的语言标识符"zh_CN"转换为了连字符格式的"zh-CN"。

技术背景

在Web开发中，语言标识符的标准化表示是一个需要注意的细节。国际标准通常建议使用连字符"-"作为语言和国家代码之间的分隔符（如zh-CN），但在某些系统实现中，可能会采用下划线"_"作为替代（如zh_CN）。这种不一致性可能导致URL路由识别失败。

影响范围

此问题影响以下版本：

• 所有releases/v*分支版本
• master分支版本

解决方案

开发团队已通过代码提交修复了此问题。修复方案确保了语言标识符在页面跳转过程中保持一致性，避免了因格式转换导致的404错误。

用户建议

对于遇到此问题的用户，可以采取以下临时解决方案：

1. 手动修改URL中的语言标识符为正确格式
2. 直接从首页重新选择目标芯片和版本
3. 等待修复更新完全部署

该问题的修复体现了ESP-IDF团队对用户体验的持续关注，也提醒开发者在处理国际化URL时需要特别注意标识符格式的一致性。