正常。Ctrl+Q显示英文文档是因为其内容来自TypeScript Server、TSDoc或JSDoc，IDE语言包仅翻译UI界面，不干预API文档层，且保留英文标识符可避免代码理解偏差。
WebStorm 中文界面下 Ctrl+Q 显示的仍是英文文档，正常吗？
完全正常。Quick Documentation（Ctrl + Q）弹窗里的内容来自 TypeScript Server、TSDoc 注释或 JSDoc，不是 WebStorm 自带翻译资源——语言包只管菜单、设置项、对话框标题等 UI 字符串，不碰 API 文档层。
这意味着：fetch 的参数说明、Promise.then() 的返回类型、React useEffect 的依赖数组规则，全以原始英文呈现。这不是配置失败，而是设计使然：保留英文标识符能避免代码理解偏差（比如把 ref 译成“参考”而非“引用”）。
- 终端输出、Git 提交信息、Node.js 堆栈错误，也全是英文——它们由运行时环境决定，IDE 语言包无权干预
- 第三方插件（如
GitToolBox、Rainbow Brackets）是否中文，取决于插件自身是否内置多语言支持 - 代码补全里的英文注释、参数名提示，属于语言服务（Language Service）范畴，和 UI 语言开关无关
想看中文解释？用 Translation 插件右键翻译，别开自动全文翻译
JetBrains 官方出品的 Translation 插件可临时辅助理解，但必须手动触发，且仅建议用于查漏补缺。
安装后，在 Ctrl + Q 弹窗内右键 → 选 Translate to Chinese，即可对当前段落做上下文感知翻译。注意：
- API 名称（如
Array.prototype.map、JSON.parse）必须保留英文——翻译插件默认跳过它们，强行译成“数组原型映射”反而误导 - 翻译质量受限于术语一致性，
props可能被翻成“属性”或“传入值”，需人工对照原始英文确认 - 不要开启“自动翻译整个文档”选项：长篇 TSDoc 一并机翻后逻辑断裂，比不看还容易出错
需要可靠中文 API 文档？直接关联 MDN 或社区中文站
WebStorm 支持一键跳转外部文档，比依赖翻译更准、更及时。
操作方式有二：
- 在
Ctrl + Q弹窗底部点击Open in Browser链接（若存在），它会自动打开对应符号的 MDN 页面 - 光标停在符号上，按
Shift + F1，或通过菜单View → External Documentation手动唤起
常见场景推荐来源：
-
fetch/DOM API→ MDN Web Docs（官方英文 + 社区维护的中文镜像，如 https://www.php.cn/link/90ca36fd9dbc796cdfacb76c9f5d677f） -
jQuery→ https://www.php.cn/link/0eca5fa085089d49d7af0e6e862746f1（稳定、更新勤、示例全） -
React/Vue→ 官方中文文档站点（注意核对版本号，避免看错分支）
别忽略“文档来源”本身——这才是阅读效率的关键
很多用户花时间调 UI 语言、装翻译插件，却没意识到：真正影响理解速度的，是文档是否来自权威源、是否匹配当前项目所用的库版本、是否有可运行示例。
比如你在用 axios@1.7.0，但查到的却是社区博客里基于 @0.21 写的中文教程，参数名和返回结构可能已变；又或者 MDN 上某个新 API 标注了 Chrome 125+，而你项目兼容到 Chrome 91，那文档再“中文”也没法用。
所以优先做三件事：确认符号来源（npm 包？浏览器原生？框架封装？）、查对应版本的官方文档、用 Shift + F1 快速比对多个来源——界面是不是中文，反而是最不关键的一环。
