VSCode中的JSDoc：为你的JavaScript代码生成文档-VSCode-PHP中文网

VSCode中的JSDoc：为你的JavaScript代码生成文档

P粉986688829

发布： 2025-12-12 16:06:58

原创

945人浏览过

VSCode通过/**开头的注释块识别JSDoc，支持@param、@returns等标签实现类型提示与参数补全，无需插件即可获得悬停提示和自动补全，配合jsdoc工具可生成HTML文档。

vscode本身不直接生成文档，但它对jsdoc有强大支持，能帮你写得规范、看得清楚、还能补全和校验——真正让文档和代码一起成长。

JSDoc怎么写才被VSCode识别

VSCode靠注释块里的特定语法识别JSDoc，不是所有注释都算数。开头必须是/**（两个星号），结尾是*/，中间每行以*开头（可选但推荐）。

✅ 正确：/** @param {string} name - 用户名 */
❌ 错误：/* @param {string} name */（少一个*）或// /** ... */（普通单行注释包裹）
函数上方紧贴着写，不要空行，VSCode才能准确关联到函数签名

常用JSDoc标签，写完立刻见效

写完标准JSDoc，把光标停在函数名或变量上，按Ctrl+Space（Windows/Linux）或Cmd+Space（macOS），就能看到类型提示和描述；调用时也会自动显示参数说明。

@param {Type} name - 描述：标注参数类型和含义，如@param {number} id - 用户唯一标识
@returns {Type}：说明返回值，如@returns {Promise}
@typedef：定义自定义类型，配合@type复用，适合复杂对象结构
@deprecated：标记废弃，VSCode会加删除线并警告

不用插件也能获得基础支持，但推荐加个轻量工具

VSCode内置JavaScript/TypeScript语言服务已支持JSDoc解析、悬停提示、自动补全——开箱即用。如果想进一步生成HTML文档，可以搭配jsdoc命令行工具（全局安装npm install -g jsdoc），然后终端运行jsdoc src/**/*.js。

SeoShop

SeoShop网店系统全站纯静态html生成更符合搜索引擎优化，并修改了以前许多js代码，取消了连接地址的js代码更换为纯div+css格式，并且所有文件可自定义url和文件名，自定义内部连接，自定义外部连接，等多个符合SEO搜索引擎优化的设置，让您的网店更容易让搜索引擎收录. 简单易用极速网店真正做到以人为本、以用户体验为中心，能使您快速搭建网上购物网站。后台管理操作简单，一目了然，没有夹杂多