VSCode 怎样通过插件实现代码的文档生成 VSCode 代码文档生成插件的使用教程​

选择合适的插件：推荐 document this 和 jsdoc generator，前者支持多种语言并自动生成 jsdoc 注释模板，后者专注于 javascript 和 typescript 且功能更强大；2. 安装插件：在 vscode 扩展市场中搜索插件名称并点击安装；3. 配置插件（可选）：在 vscode 设置中自定义注释模板、作者信息等，document this 配置简单，jsdoc generator 可深度定制；4. 生成文档：将光标置于函数、类或变量声明上方，使用快捷键 ctrl+shift+d（document this）或 ctrl+shift+2（jsdoc generator）生成注释模板并填写内容；5. 生成文档网站：安装 node.js 和 npm 后运行 npm install -g jsdoc 安装 jsdoc 工具，项目根目录下执行 jsdoc . 命令生成静态网站，默认输出至 out 目录，可通过 jsdoc.conf.json 文件定制样式；6. 部署文档网站：可将生成的静态网站部署到 github pages（免费托管，适合开源项目）、netlify 或 vercel（支持自动构建部署）或自有服务器，确保访问权限公开以便他人查阅。

VSCode 配合合适的插件，能轻松生成代码文档，省时省力。关键在于选对插件，配置好，然后一键生成！

解决方案（直接输出解决方案即可）

1. 选择合适的插件： VSCode 市场里代码文档生成插件不少，但好用的就那么几个。 推荐 Document This 和 JSDoc Generator。 Document This 支持多种语言，自动生成 JSDoc 风格的注释模板，用起来非常方便。 JSDoc Generator 则专注于 JavaScript 和 TypeScript，功能更强大，可以根据已有的代码结构生成更完善的文档。

2. 安装插件： 打开 VSCode，点击侧边栏的扩展按钮（或者按

   Ctrl+Shift+X

   ），搜索你选择的插件名字，比如 "Document This"，然后点击 "Install" 安装。

3. 配置插件（可选）： 有些插件允许自定义配置，比如注释模板的格式、作者信息等等。 可以在 VSCode 的设置里找到插件的配置项，根据自己的需求进行修改。 Document This 的配置项比较简单，一般不需要修改。 JSDoc Generator 的配置项比较多，可以仔细研究一下。

4. 生成文档： 安装好插件后，就可以开始生成文档了。 把光标放在函数、类或者变量的声明上方，然后按下插件的快捷键。 Document This 默认快捷键是

   Ctrl+Shift+D

   （Windows/Linux）或者

   Cmd+Shift+D

   （Mac）。 JSDoc Generator 快捷键是

   Ctrl+Shift+2

   。 插件会自动生成 JSDoc 风格的注释模板，你只需要填写具体的注释内容就可以了。

5. 生成文档网站： 插件生成的是 JSDoc 风格的注释，如果想要生成漂亮的文档网站，还需要借助 JSDoc 工具。 首先，需要安装 Node.js 和 npm。 然后，在命令行里运行

   npm install -g jsdoc

   安装 JSDoc 工具。 安装完成后，在你的项目根目录下运行

   jsdoc .

   命令，JSDoc 会自动扫描你的代码，生成文档网站。 文档网站默认保存在

   out

   目录下。 你可以修改 JSDoc 的配置文件

   jsdoc.conf.json

   来定制文档网站的样式和内容。

VSCode 代码文档生成插件有哪些选择？

除了上面提到的 Document This 和 JSDoc Generator，还有一些其他的插件也可以用来生成代码文档。比如：

• koroFileHeader: 这个插件主要用来生成文件头注释，可以自动添加作者、创建时间、修改时间等信息。 虽然不能生成完整的 JSDoc 文档，但可以规范代码风格，方便团队协作。

• Better Comments: 这个插件可以用来美化代码注释，用不同的颜色和样式来区分不同类型的注释，比如警告、错误、待办事项等等。 虽然不能自动生成文档，但可以提高代码的可读性，方便其他人理解你的代码。

选择哪个插件，主要看你的需求和个人喜好。 如果你只需要简单的 JSDoc 注释模板，Document This 就足够了。 如果你需要更强大的文档生成功能，JSDoc Generator 是更好的选择。 如果你更关注代码风格和可读性，可以考虑 koroFileHeader 和 Better Comments。

拍我AI

AI视频生成平台PixVerse的国内版本

下载

如何自定义 VSCode 代码文档生成插件的注释模板？

Document This 插件允许自定义注释模板，你可以根据自己的需求修改模板的格式和内容。 打开 VSCode 的设置，搜索 "documentThis.jsdoc"。 你会看到一个名为 "documentThis.jsdoc.template" 的配置项，它的值是一个字符串，表示 JSDoc 注释模板。

你可以修改这个字符串，来定制注释模板的格式。 比如，你可以添加自己的作者信息、公司信息等等。 Document This 使用了一些特殊的占位符，比如

${name}

${type}

${description}

注意，修改注释模板可能会影响代码的可读性，所以要谨慎操作。 建议先备份原始模板，然后再进行修改。

JSDoc 生成的文档网站如何部署到服务器上？

JSDoc 生成的文档网站就是一个普通的 HTML 网站，你可以把它部署到任何支持静态网站托管的服务器上。 常见的选择包括：

• GitHub Pages: 如果你使用 GitHub 管理你的代码，可以使用 GitHub Pages 来免费托管你的文档网站。 只需要把文档网站放到一个名为

  docs

  的文件夹里，然后启用 GitHub Pages 功能就可以了。

• Netlify: Netlify 是一个现代化的 Web 开发平台，可以用来快速部署静态网站。 只需要把你的代码仓库连接到 Netlify，然后 Netlify 会自动构建和部署你的文档网站。

• Vercel: Vercel 也是一个流行的 Web 开发平台，和 Netlify 类似，可以用来快速部署静态网站。

• 自己的服务器: 如果你有自己的服务器，也可以把文档网站放到服务器的 Web 目录下，然后配置好域名和 SSL 证书就可以了。

选择哪种部署方式，主要看你的需求和预算。 如果你只是想简单地托管文档网站，GitHub Pages 是一个不错的选择。 如果你需要更强大的功能，比如自动构建和部署，可以考虑 Netlify 或 Vercel。 如果你有自己的服务器，可以自己配置。

无论选择哪种部署方式，都需要确保文档网站的访问权限是公开的，这样其他人才能访问你的文档。