JSCS validateJSDoc错误文件顶部关闭或注释不支持的错误规则

Question

我已经使用Gulp为AngularJS应用程序使用Gulp设置了JShint和JSCS，并使用JShint和JSCS文档作为选项，并且JSHint可以正常工作，但是当与JSCS一起使用时，每个文件都与IIFE或在文件顶部添加注释。

gulp.task('vet', function () {

    var files = [
        './resources/assets/js/**/*.js',
        '!./resources/assets/js/services/services.httpi.js',
        './*.js'
    ];

    return gulp.src(files)
               .pipe(jscs())
               .pipe(jscs.reporter())
               .pipe(jshint())
               .pipe(jshint.reporter('jshint-stylish', {verbose: true}));
});

但是，当我运行vet任务时，我的所有文件都收到此错误：

[15:15:41] Starting 'vet'...
Unsupported rule: validateJSDoc at D:\projects\app\resources\assets\js\app.config.js :
     1 |(function () {
--------^
     2 |
     3 |    'use strict';

我曾尝试将“严格使用”移出封闭状态（草率，但需要查看其是否有效）

或者，我也尝试在闭包之前添加注释，但得到相同的错误，但它指向注释：

2 code style errors found.
Unsupported rule: validateJSDoc at D:\projects\app\resources\assets\js\app.module.js :
     1 |/**
--------^
     2 | * Application Module
     3 | * @namespace Application

JSCS是否期望文件以特定的开头？ 有人知道怎么修这个东西吗？

Answer 1

查看可用的JSCS规则 。 没有validateJSDoc ，只有jsDoc 。 原因是validateJSDoc 在JSCS 2.0中被弃用并丢弃 。

从您的.jscsrc （或您使用的任何配置文件）中删除该规则，或对其进行修复以使其与较新的jsDoc兼容。