{"id":684164,"date":"2026-02-27T08:25:23","date_gmt":"2026-02-27T07:25:23","guid":{"rendered":"https:\/\/blog.jetbrains.com\/?post_type=platform&p=684164"},"modified":"2026-02-27T09:11:44","modified_gmt":"2026-02-27T08:11:44","slug":"extending-qodana-adding-custom-code-inspections","status":"publish","type":"platform","link":"https:\/\/blog.jetbrains.com\/zh-hans\/platform\/2026\/02\/extending-qodana-adding-custom-code-inspections\/","title":{"rendered":"\u6269\u5c55 Qodana\uff1a\u6dfb\u52a0\u81ea\u5b9a\u4e49\u4ee3\u7801\u68c0\u67e5"},"content":{"rendered":"\n

Qodana \u662f\u4e00\u6b3e\u9759\u6001\u4ee3\u7801\u5206\u6790\u5de5\u5177\uff0c\u5c06 JetBrains IDE \u4e2d\u7684\u4ee3\u7801\u68c0\u67e5<\/a>\u548c\u5feb\u901f\u4fee\u590d\u529f\u80fd\u5f15\u5165\u6301\u7eed\u96c6\u6210\u9886\u57df\u3002\u5b83\u53ef\u4ee5\u5728\u4e91\u7aef<\/a>\u8fd0\u884c\u3001\u901a\u8fc7 Docker \u5bb9\u5668\u6267\u884c<\/a>\u3001\u96c6\u6210<\/a>\u5230 CI\/CD \u7ba1\u9053\u4e2d\uff0c\u4e5f\u53ef\u4ee5\u901a\u8fc7 JetBrains IDE \u8c03\u7528\u3002<\/p>\n\n\n\n

Qodana \u5df2\u63d0\u4f9b\u4e00\u5957\u5b8c\u5584\u7684\u68c0\u67e5\uff0c\u4f46\u5b83\u5e76\u4e0d\u5c40\u9650\u4e8e\u5185\u7f6e\u68c0\u67e5\u3002\u60a8\u53ef\u4ee5\u6dfb\u52a0\u81ea\u5b9a\u4e49\u68c0\u67e5\uff0c\u4ee5\u5f3a\u5236\u5b9e\u65bd\u9879\u76ee\u7279\u5b9a\u89c4\u8303\u548c\u7ea6\u5b9a\u3002<\/p>\n\n\n\n

\u4f8b\u5982\uff0c\u5047\u8bbe\u4e00\u4e2a\u9879\u76ee\u91c7\u7528\u7279\u5b9a\u7684\u4ee3\u7801\u7ea6\u5b9a\uff1a<\/p>\n\n\n\n

\n

service<\/code> <\/mark>\u8f6f\u4ef6\u5305\u4e2d\u7684\u6bcf\u4e2a Kotlin \u7c7b\u90fd\u5fc5\u987b\u6709 Service<\/code> \u540e\u7f00\u3002<\/p>\n<\/blockquote>\n\n\n\n

\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0ccom.jetbrains.service.JetComponent<\/code> \u4e0d\u7b26\u5408\u6b64\u7ea6\u5b9a\uff0c\u800c com.jetbrains.service.BrainComponentService<\/code> \u5219\u5b8c\u5168\u7b26\u5408\u6b64\u7ea6\u5b9a\u3002\u63a5\u4e0b\u6765\uff0c\u6211\u4eec\u5c06\u6784\u5efa\u4e00\u4e2a\u5b9e\u73b0\u6b64\u68c0\u67e5\u7684\u63d2\u4ef6\uff0c\u8ba9 Qodana \u80fd\u591f\u5728\u4eca\u540e\u7684\u9879\u76ee\u4e2d\u5f3a\u5236\u9075\u5faa\u8fd9\u9879\u7ea6\u5b9a\u3002<\/p>\n\n\n\n

\u6211\u4eec\u53ef\u4ee5\u901a\u8fc7\u521b\u5efa\u4e00\u4e2a\u5c01\u88c5\u5230\u63d2\u4ef6<\/strong>\u4e2d\u7684\u81ea\u5b9a\u4e49\u4ee3\u7801\u68c0\u67e5<\/strong>\u6765\u5b9e\u73b0\u6b64\u4ee3\u7801\u7ea6\u5b9a\u3002Qodana \u63d2\u4ef6\u7684\u5f00\u53d1\u65b9\u5f0f\u4e0e JetBrains IDE \u63d2\u4ef6\u76f8\u540c\uff0c\u4e5f\u5c31\u662f\u8bf4\uff0c\u6211\u4eec\u53ea\u9700\u521b\u5efa\u4e00\u4e2a\u53ef\u4ee5\u5728 Qodana \u4e2d\u8fd0\u884c\u7684 IntelliJ Platform \u63d2\u4ef6\u3002\u4ee5\u4e0b\u662f\u6211\u4eec\u5c06\u91c7\u53d6\u7684\u6b65\u9aa4\u7684\u5feb\u901f\u6982\u8ff0\uff1a<\/p>\n\n\n\n

    \n
  1. \u901a\u8fc7 IntelliJ Platform \u63d2\u4ef6\u6a21\u677f<\/a>\u521d\u59cb\u5316\u9879\u76ee\u3002<\/li>\n\n\n\n
  2. \u8c03\u6574\u9879\u76ee\u5c5e\u6027\u3001\u63d2\u4ef6\u63cf\u8ff0\u7b26\u4ee5\u53ca\u5fc5\u8981\u7684\u4f9d\u8d56\u9879\u3002<\/li>\n\n\n\n
  3. \u5728\u63d2\u4ef6\u63cf\u8ff0\u7b26\u4e2d\u58f0\u660e\u5c40\u90e8\u68c0\u67e5\uff0c\u5e76\u4f7f\u7528 Kotlin \u5b9e\u73b0\u68c0\u67e5\u3002<\/li>\n\n\n\n
  4. \u6784\u5efa\u63d2\u4ef6\u5e76\u8fdb\u884c\u5c01\u88c5\u3002<\/li>\n\n\n\n
  5. \u5728\u793a\u4f8b\u6f14\u7ec3\u573a\u9879\u76ee\u4e2d\uff0c\u5c06\u63d2\u4ef6\u5de5\u4ef6\u653e\u5165\u9002\u5f53\u7684\u76ee\u5f55\u3002<\/li>\n\n\n\n
  6. \u8c03\u6574 Qodana \u914d\u7f6e\u6587\u4ef6\u3002<\/li>\n\n\n\n
  7. \u8fd0\u884c Qodana \u5e76\u67e5\u770b\u62a5\u544a\uff01<\/li>\n<\/ol>\n\n\n\n

    \u51c6\u5907\u63d2\u4ef6\u9879\u76ee<\/h2>\n\n\n\n

    \u8981\u521d\u59cb\u5316\u9879\u76ee\uff0c\u8bf7\u8bbf\u95ee IntelliJ Platform \u63d2\u4ef6\u6a21\u677f<\/a>\u4ed3\u5e93\uff0c\u5e76\u70b9\u51fb Use this template<\/em>\uff08\u4f7f\u7528\u6b64\u6a21\u677f\uff09\u6309\u94ae\u521b\u5efa\u63d2\u4ef6\u4ed3\u5e93\u3002\u5c06\u5176\u547d\u540d\u4e3a classname-inspection-qodana-plugin<\/code>\uff0c\u590d\u5236\u9879\u76ee URL\uff0c\u5e76\u5728 IntelliJ IDEA \u4e2d\u6253\u5f00\u9879\u76ee\u3002\u9879\u76ee\u51c6\u5907\u5c31\u7eea\u540e\uff0c\u6839\u636e\u9700\u8981\u58f0\u660e pluginGroup<\/code>\u3001pluginName<\/code> \u548c pluginRepositoryUrl<\/code>\uff0c\u4ee5\u81ea\u5b9a\u4e49 gradle.properties<\/code>\u3002\u8bb0\u5f97\u70b9\u51fb Sync Gradle Changes<\/em>\uff08\u540c\u6b65 Gradle \u66f4\u6539\uff09\u60ac\u6d6e\u5f0f\u6309\u94ae\u5e94\u7528\u66f4\u6539\u3002\u8981\u4fee\u6539\u72ec\u4e00\u65e0\u4e8c\u7684\u63d2\u4ef6\u6807\u8bc6\u7b26<\/a>\uff0c\u8bf7\u5728\u63d2\u4ef6\u63cf\u8ff0\u7b26 plugin.xml<\/code> \u4e2d\u66f4\u6539 id<\/code> \u5143\u7d20\u3002<\/p>\n\n\n\n

    \u58f0\u660e\u4f9d\u8d56\u9879<\/h3>\n\n\n\n

    \u6211\u4eec\u7684\u4ee3\u7801\u68c0\u67e5\u9488\u5bf9\u7684\u662f Kotlin \u7c7b\uff0c\u56e0\u6b64\uff0c\u6211\u4eec\u9700\u8981\u5c06 Kotlin \u63d2\u4ef6\u6dfb\u52a0\u5230 Qodana \u63d2\u4ef6\u7684\u4f9d\u8d56\u9879\u3002gradle.properties<\/code> \u6587\u4ef6\u9700\u8981\u58f0\u660e\uff1a<\/p>\n\n\n\n

    platformBundledPlugins = org.jetbrains.kotlin<\/pre>\n\n\n\n
    \u6b64\u5916\uff0c\u63d2\u4ef6\u63cf\u8ff0\u7b26 plugin.xml<\/code> \u5fc5\u987b\u5728\u5176\u4f9d\u8d56\u9879\u4e2d\u5305\u542b\u76f8\u540c\u7684\u6346\u7ed1 Kotlin \u63d2\u4ef6\uff1a<\/p>\n\n\n\n
    <depends>org.jetbrains.kotlin<\/depends><\/pre>\n\n\n\n
    \u518d\u6b21\u63d0\u9192\uff0c\u8bf7\u52a1\u5fc5\u70b9\u51fb\u60ac\u6d6e\u5f0f\u6309\u94ae\u540c\u6b65 Gradle \u66f4\u6539\u3002<\/p>\n\n\n\n
    \u6b64\u5916\uff0cKotlin \u7c7b\u68c0\u67e5\u9700\u8981\u652f\u6301 Kotlin K2 \u7f16\u8bd1\u5668\uff0c\u81ea 2025.1 \u7248 IntelliJ Platform \u8d77\uff0c\u8be5\u7f16\u8bd1\u5668\u9ed8\u8ba4\u542f\u7528\u3002\u5728\u63d2\u4ef6\u63cf\u8ff0\u7b26\u4e2d\uff0c\u58f0\u660e org.jetbrains.kotlin.supportsKotlinPluginMode<\/code> \u6269\u5c55\u3002<\/p>\n\n\n\n
    <extensions defaultExtensionNs=\"org.jetbrains.kotlin\">\n    <supportsKotlinPluginMode supportsK2=\"true\" \/>\n<\/extensions><\/pre>\n\n\n\n
    \u521b\u5efa\u4ee3\u7801\u68c0\u67e5<\/h3>\n\n\n\n
    \u9488\u5bf9 Kotlin \u7c7b\u7684\u4efb\u4f55\u4ee3\u7801\u68c0\u67e5\u7684\u5b9e\u9645\u4ee3\u7801\u9700\u8981\u4e09\u4e2a\u6b65\u9aa4\uff1a<\/p>\n\n\n\n
      \n
    1. \u5728\u63d2\u4ef6\u63cf\u8ff0\u7b26\u4e2d\u58f0\u660e com.intellij.localInspection<\/code> \u6269\u5c55\uff0c\u540c\u65f6\u58f0\u660e\u5fc5\u8981\u7684\u7279\u6027\uff0c\u4ee5\u53ca\u5bf9\u5b9e\u73b0\u7c7b\u7684\u5b8c\u5168\u9650\u5b9a\u5f15\u7528\u3002<\/li>\n\n\n\n
    2. \u521b\u5efa\u5b9e\u73b0\u7c7b\uff0c\u6700\u597d\u4f7f\u7528 Kotlin\u3002<\/li>\n\n\n\n
    3. \u63d0\u4f9b\u5305\u542b\u68c0\u67e5\u63cf\u8ff0\u3001\u7528\u6cd5\u6307\u5bfc\u548c\u793a\u4f8b\u7684\u72ec\u7acb HTML \u6587\u4ef6\u3002<\/li>\n<\/ol>\n\n\n\n
      \u58f0\u660e\u6269\u5c55<\/h4>\n\n\n\n
      \u5411 plugin.xml<\/code> \u63d2\u4ef6\u63cf\u8ff0\u7b26\u6587\u4ef6\u6dfb\u52a0\u4ee5\u4e0b\u58f0\u660e\uff1a<\/p>\n\n\n\n
      <extensions defaultExtensionNs=\"com.intellij\">\n    <localInspection\n        language=\"kotlin\"\n        implementationClass=\"org.intellij.sdk.codeInspection.ServicePackageClassNameInspection\"\n        enabledByDefault=\"true\"\n        displayName=\"SDK: Discouraged class name\"\n        groupName=\"Kotlin\"\n    \/>\n<\/extensions><\/pre>\n\n\n\n
      language<\/code> \u7279\u6027\u6307\u793a\u68c0\u67e5\u9002\u7528\u4e8e Kotlin \u6e90\u4ee3\u7801\u6587\u4ef6\u3002\u52a1\u5fc5\u660e\u786e\u9ed8\u8ba4\u542f\u7528\u68c0\u67e5\uff0c\u5426\u5219 Qodana \u5c06\u4e0d\u4f1a\u8fd0\u884c\u6b64\u68c0\u67e5\u3002\u7136\u540e\uff0c\u63d0\u4f9b\u4eba\u7c7b\u53ef\u8bfb\u7684\u63cf\u8ff0\u6027 displayName<\/code>\uff0c\u4ee5\u663e\u793a\u5728\u62a5\u544a\u548c\u8bbe\u7f6e\u4e2d\u3002groupName<\/code> \u7279\u6027\u7528\u4e8e\u8bbe\u7f6e\u5c06\u5728 Qodana \u62a5\u544a\u548c IDE \u8bbe\u7f6e\u4e2d\u663e\u793a\u7684\u68c0\u67e5\u7c7b\u522b\u3002\u6700\u540e\uff0c\u4e3a\u5b9e\u73b0\u7c7b\u63d0\u4f9b\u5b8c\u5168\u9650\u5b9a\u540d\u79f0\u3002<\/p>\n\n\n\n
      \u4ee3\u7801\u68c0\u67e5\u6e90\u4ee3\u7801<\/h4>\n\n\n\n
      Kotlin \u63d2\u4ef6\u4e3a Kotlin \u68c0\u67e5\u63d0\u4f9b\u4e86\u4e00\u4e2a\u5b9e\u7528\u7684\u57fa\u7840\u68c0\u67e5\u7c7b\uff1aAbstractKotlinInspection<\/code>\u3002\u91cd\u5199 buildVisitor<\/code> \u65b9\u6cd5\uff0c\u5e76\u63d0\u4f9b\u4e00\u4e2a PSI \u8bbf\u95ee\u5668\u5b9e\u4f8b\uff0c\u8be5\u5b9e\u4f8b\u4ee5\u7c7b\u578b\u5b89\u5168\u7684\u65b9\u5f0f\u904d\u5386 Kotlin \u7c7b\u5143\u7d20\u3002classVisitor<\/code> \u662f\u4e00\u4e2a\u7c7b\u4f3c DSL \u7684\u4fbf\u6377\u51fd\u6570\uff0c\u4f1a\u8fd4\u56de\u8fd9\u79cd\u7c7b\u578b\u7684 PSI \u8bbf\u95ee\u5668\uff0c\u5e76\u5728\u60a8\u68c0\u67e5\u7684\u9879\u76ee\u4e2d\u7684\u4efb\u4f55 Kotlin \u7c7b\u4e0a\u8c03\u7528\u3002<\/p>\n\n\n\n
      package org.intellij.sdk.codeInspection\n\nimport com.intellij.codeInspection.ProblemHighlightType\nimport com.intellij.codeInspection.ProblemsHolder\nimport com.intellij.psi.PsiElementVisitor\nimport org.jetbrains.kotlin.idea.codeinsight.api.classic.inspections.AbstractKotlinInspection\nimport org.jetbrains.kotlin.psi.KtClass\nimport org.jetbrains.kotlin.psi.KtVisitorVoid\nimport org.jetbrains.kotlin.psi.classVisitor\n\nclass ServicePackageClassNameInspection : AbstractKotlinInspection() {\n    override fun buildVisitor(holder: ProblemsHolder, isOnTheFly: Boolean) = classVisitor { klass ->\n        val classNamePsi = klass.nameIdentifier ?: return@classVisitor\n        val classFqn = klass.fqName?.asString() ?: return@classVisitor\n        if (klass.packageLastComponent == \"service\" && !classFqn.endsWith(\"Service\")) {\n            holder.registerProblem(\n                classNamePsi,\n                \"Class name in the 'service' package must have a 'Service' suffix\"\n            )\n        }\n    }\n\n    private val KtClass.packageLastComponent: String\n        get() = containingKtFile.packageFqName.shortName().asString()\n}<\/pre>\n\n\n\n
      \u8be5\u8bbf\u95ee\u5668\u5b50\u7c7b\u4f1a\u63d0\u53d6 Kotlin \u5b8c\u5168\u9650\u5b9a\u7c7b\u540d\uff0c\u68c0\u67e5\u6700\u53f3\u4fa7\u7684\u8f6f\u4ef6\u5305\u5143\u7d20\uff0c\u5e76\u68c0\u67e5\u76f8\u5e94\u7684\u540e\u7f00\u3002\u4efb\u4f55\u4e0d\u5408\u9002\u7684\u7c7b\u540d\u90fd\u4f1a\u88ab\u4e0a\u62a5\u7ed9 ProblemsHolder<\/code> \u5b9e\u4f8b\uff0c\u4e0a\u62a5\u65f6\u4f1a\u63d0\u4f9b\u5c01\u95ed\u7c7b\u4f5c\u4e3a PSI \u5143\u7d20\uff0c\u5e76\u63d0\u4f9b\u4eba\u7c7b\u53ef\u8bfb\u7684\u95ee\u9898\u63cf\u8ff0\u3002<\/p>\n\n\n\n
      \u68c0\u67e5\u63cf\u8ff0<\/h4>\n\n\n\n
      \u6bcf\u4e2a\u5c40\u90e8\u68c0\u67e5\u90fd\u9700\u8981\u4e00\u4e2a\u4ee5 HTML \u683c\u5f0f\u5448\u73b0\u7684\u914d\u5957\u63cf\u8ff0\u6587\u4ef6\u3002\u5982\u679c\u60a8\u4f7f\u7528 Create description file ServicePackageClassNameInspection.html<\/em> \u5feb\u901f\u4fee\u590d\uff0c\u5c06\u5728\u9002\u5f53\u7684\u4f4d\u7f6e\u521b\u5efa\u540d\u4e3a src\/main\/resources\/inspectionDescriptions\/ServicePackageClassName.html<\/code> \u7684\u6587\u4ef6\u3002\u60a8\u8fd8\u9700\u8981\u63d0\u4f9b\u5c06\u5728 Qodana \u62a5\u544a\u548c IDE \u8bbe\u7f6e\u4e2d\u663e\u793a\u7684\u63cf\u8ff0\u3002<\/p>\n\n\n\n
      <html>\n<body>\nReports class names in the <code>service<\/code> packages that lack the <code>Service<\/code> suffix.\n<p><b>Example:<\/b><\/p>\n<pre><code>\n  package com.example.foo.service\n  class SomeComponent {\n    \/* class members *\/\n  }\n<\/code><\/pre>\n<\/body>\n<\/html><\/pre>\n\n\n\n
      \u6784\u5efa\u63d2\u4ef6<\/h2>\n\n\n\n
      \u4e00\u5207\u5c31\u7eea \u2013 \u8be5\u5f00\u59cb\u6784\u5efa\u4e86\uff01 \u6267\u884c buildPlugin<\/code> Gradle \u4efb\u52a1\uff0c\u5e76\u67e5\u770b Gradle \u8f93\u51fa\u76ee\u5f55\u4e2d\u7684 build\/distributions\/qodana-code-inspection-0.0.1.zip<\/code> \u5de5\u4ef6\u3002\u8be5 JAR \u6587\u4ef6\u5c06\u7528\u4f5c Qodana \u626b\u63cf\u4e2d\u7684\u4e3b\u8981\u5de5\u4ef6\u3002 <\/p>\n\n\n\n
      \u8bf7\u8bb0\u4f4f\u8be5\u63d2\u4ef6\u5de5\u4ef6\u7c7b\u578b<\/h4>\n\n\n\n
      Qodana \u4e0d\u76f4\u63a5\u652f\u6301\u5305\u542b\u9644\u52a0 JAR \u5f52\u6863\u6216\u7b2c\u4e09\u65b9\u4f9d\u8d56\u9879\u7684\u672c\u5730 ZIP \u63d2\u4ef6\u5de5\u4ef6\u3002\u4efb\u4f55\u63d2\u4ef6\u90fd\u9700\u8981\u6253\u5305\u4e3a\u5355\u4e2a JAR \u6587\u4ef6\uff0c\u6216\u89e3\u538b\u5230\u7279\u5b9a\u76ee\u5f55\u4e2d\u3002<\/p>\n\n\n\n
      \u5728\u6f14\u7ec3\u573a\u9879\u76ee\u4e0a\u8fd0\u884c Qodana<\/h2>\n\n\n\n
      \u6211\u4eec\u6765\u521b\u5efa\u4e00\u4e2a\u4f7f\u7528 Kotlin \u7f16\u5199\u7684\u6f14\u7ec3\u573a\u9879\u76ee\uff0c\u7531\u4e8e\u6211\u4eec\u5df2\u901a\u8fc7\u63d2\u4ef6\u5bf9 Qodana \u8fdb\u884c\u4e86\u6269\u5c55\uff0c\u73b0\u5728\u53ef\u4ee5\u4f7f\u7528 Qodana \u8fdb\u884c\u68c0\u67e5\u3002\u8981\u5728\u672c\u5730\u8fd0\u884c Qodana \u63d2\u4ef6\uff0c\u8bf7\u786e\u4fdd\u60a8\u7684\u7cfb\u7edf\u4e0a\u5b89\u88c5\u4e86\u4ee5\u4e0b\u4e24\u4e2a\u8f6f\u4ef6\u7ec4\u4ef6\uff1a<\/p>\n\n\n\n