CODESS 代码片段工具

codess是一个管理vscode代码片段提示的一个npm包，codess可以安装网站上的公共包，也可以安装本地自定义的包，codess安装的包是片段包，是一个代码片段的集合，里面有很多自定义的代码片段。

您如果不了解什么是vscode代码片段提示的话请看下一章，您如果不了解codess的工作原理的话，请看另一章节。

您只需要几步就能使用codess了

1：第一步，安装codess

您得确定您已经安装过node.js

npm install --global codess

2：第二步，使用codess安装一个代码包

这里我们安装一个叫做codess-example的包，版本是1.0.0，注意：因为代码片段需要基于一个node项目，所以您可以随意建一个node项目试试。没有版本号的话安装默认版本。

codess install codess-example@1.0.0

3：第三步，随意打开项目中得一个js文件，并在其中输入:for

现在您的vscode已经可以很智能的根据触发词筛选出您想要的代码片段了。如果您不想打开vscode，您可以使用片段包预览来模拟vsoode输入触发词会有什么片段提示。

codess结构化的管理您的代码片段，方便快捷。

一些常用的用法

除了安装，您还可以初始化，卸载，安装本地包。

初始化

codess init

卸载包

codess uninstall codess-example@1.0.0

打包

直接根据配置文件打包为 .code-snippets vscode配置文件。其中有远程包的会重新下载。

codess build

清除已生成的vscode代码片段配置

清除当前项目下已生成的vscode代码片段配置 ./vscode/*.codess.code-snippets

codess clear-snippets

codess配置文件

codess配置文件是项目根目录下的 codess.config.json 文件。

{
    // 依赖的代码片段包列表
    "dependent": [],
    // 包安装记录，主要记录已安装包的信息
    "installRecord": {},
    // codess 官方文档
    "document": "https://codess.dumogu.top/doc"
}

示例：

{
    "dependent": [
        {
            // 包名
            "package": "vue",
            // 包触发词
            "prefix": "v",
        },
        {
          "package": "file:snippets",// 一个本地片段包 ./snippets/
          "prefix": "my"
        }
    ],
    "installRecord": {
      "vue": {
          "home": "",
          "description": "",
          "version": "3",
          "iterationNumber": "1"
        }
    },
    "document": "https://codess.dumogu.top/doc"
}

CODESS 代码片段工具，自定义您的vscode代码片段。