Debian 中查阅 JavaScript 文档的实用方法
一 在线权威文档
- 首选查阅 MDN Web Docs（Mozilla Developer Network），覆盖 JavaScript 语言、DOM、Web API 等，中文界面便于快速检索。用法：打开 https://developer.mozilla.org/zh-CN/，在搜索框输入对象或方法名（如 Array、Promise、fetch），进入条目后可查看描述、属性、方法、示例、规范与浏览器兼容性；页面右上角可切换语言。示例条目：Math 对象页面（https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Math）。此外，也可参考 W3C 的教程资料作为补充。
二 终端离线浏览
- 无图形界面时，可用终端浏览器 links2 直接在线查看文档：
- 安装：sudo apt install links2
- 使用：links2 后输入文档 URL（如 https://developer.mozilla.org/zh-CN/），支持页面内搜索与基本导航；按 Alt+F 呼出菜单。该方式适合服务器或纯 CLI 环境查阅 JS 文档。
三 本地 Node.js API 文档
- 若需查阅 Node.js 内置模块与 API，先安装 Node.js 与 npm（Debian 常见做法：sudo apt install nodejs npm；或按项目需要添加 NodeSource 仓库安装指定版本）。安装完成后可用 npm 安装本地文档浏览工具（如 node-doc 等）并通过本地服务或命令行查看；同时建议将 Node.js 官方文档作为权威参考，结合本地工具离线检索与示例学习。
四 项目内与生成文档
- 使用 JSDoc 为你的 JavaScript 代码生成 API 文档：在项目中按 JSDoc 规范编写注释，执行生成命令后输出 HTML 文档站点，便于团队协作与离线查阅。配合 ESLint、Prettier 等工具可保持注释与代码风格一致，提升文档质量与可维护性。