静态分析

Vize的分析栈由编译器、linter、类型检查器、编辑器服务器和Musea共享 工具。目标是解析一次Vue SFC，保留丰富的语义信息，并重复利用 用于诊断和代码生成，而不是把每个命令当作独立的工具。

以下示例假设vize npm包是通过项目脚本安装并调用的，这些脚本 是应用程序推荐的工作流程。

管道

这意味着静态分析不仅仅是绒毛。模板绑定、编译器宏、组件 元数据、提供/注入关系、反应流、生成的虚拟 TypeScript，以及 组件画廊的元数据都依赖于相同的底层分析工作。

关于具体的规则名称、默认值和可以输出的跨文件诊断代码，请参见 规则。

绒毛

从默认预设开始：

{
  "scripts": {
    "vize:lint": "vize lint src"
  }
}

vp run vize:lint

仅正确性CI使用essential，happy-path默认推荐的捆绑包， opinionated当你想要更强的约定时，nuxt Nuxt感知假设， incremental你只想让明确配置的规则运行。

{
  "scripts": {
    "vize:lint:ci": "vize lint --preset essential --max-warnings 0 src",
    "vize:lint:opinionated": "vize lint --preset opinionated --help-level short src",
    "vize:lint:fix": "vize lint --fix src",
    "vize:lint:json": "vize lint --format json src"
  }
}

vp run vize:lint:ci
vp run vize:lint:opinionated
vp run vize:lint:fix
vp run vize:lint:json

只有在基本lint路径稳定后，才选择进行跨文件和类型识别检查：

{
  "scripts": {
    "vize:lint:cross-file": "vize lint --cross-file src",
    "vize:lint:cross-file-tree": "vize lint --cross-file --cross-file-tree src",
    "vize:lint:strict-reactivity": "vize lint --strict-reactivity src"
  }
}

vp run vize:lint:cross-file
vp run vize:lint:cross-file-tree
vp run vize:lint:strict-reactivity

跨文件线条分析了一系列 Vue文件。--strict-reactivity启用了本地的检测器支持的反应性损失规则，所以可以期待它 比普通模板和脚本 lint 规则慢。

反应性叠加

Croquis为每个分析的SFC暴露出稳定的反应性叠加：反应源、.value 需求、反应性损失位点和带源映射的效应图边。同一个紧凑 JSON 模型提供诊断、报告、编辑器表面以及 Playground 的Reactivity标签页。

铜绿规则模型

铜绿层是绒毛的规则层。规则是小访客通过SFC源代码模板根， 模板元素、指令、 v-for、v-if 和插值。每条规则都包含 的元数据 规则名称、类别、默认严重度、帮助文本以及是否可修复。预设只是 决定哪些规则可以一起启用的注册机构。

内置预设旨在分阶段支持采用：

移民规范与习俗规则

Patina 接受现有的 ESLint 禁用语用来匹配规则名，包括 eslint-disable、eslint-enable、eslint-disable-next-line和eslint-disable-line。这使得 项目迁移规则如vue/require-v-for-key而无需重写每一条抑制评论 前面。

项目本地的JavaScript规则模块还不是稳定的Vize运行时API。迁徙期间，保持 这些规则在ESLint或Oxlint中运行，并与vize lint并列运行，或者使用incremental预设 只启用已经与你政策相匹配的内置 Vize 规则。rules配置对象控件 内置的 Vize 通过名称规则严重度。

对于禁止运行时环境全局（典型的sidecar-ESLint规则，如 no-access-process、no-access-local-storage或no-restricted-globals对localStorage / sessionStorage），启用自愿加入的内置script/no-restricted-globals规则，而不是保留 只为这些人安装了ESLint。其默认拒绝列表为process、localStorage和 sessionStorage，在每一个裸露的参考文献中都有报道。

两个脚本规则也接受项目本地配置，linter.ruleOptions（#1891），因此团队 可以通过vize lint强制执行自己的架构规范。script/no-restricted-globals 接受一个globals列表，替换内置默认列表;script/no-restricted-members是 关闭直到配置，并标记<object>.<property> members列表中的访问。选项被输入 （name / object / property 加上一个可选的 message，拒绝未知键）;一个失踪的 message只能依赖通用的建议。

{
  "linter": {
    "rules": {
      "script/no-restricted-globals": "error",
      "script/no-restricted-members": "error"
    },
    "ruleOptions": {
      "script/no-restricted-globals": {
        "globals": [
          { "name": "process", "message": "Read env via a typed helper." },
          { "name": "alert" }
        ]
      },
      "script/no-restricted-members": {
        "members": [
          { "object": "window", "property": "localStorage", "message": "Use authStorage." }
        ]
      }
    }
  }
}

跨档规则

跨文件分析者居住在克罗奎斯，通过铜绿诊断暴露于绒毛现象。确实如此 选择加入，因为它构建模块注册表、导入图、组件使用图等 所有分析的Vue文件的索引。

如今，vize lint --cross-file支持提供/注入匹配、唯一元素ID检查， 反应性追踪和异步竞赛-条件分析。--cross-file-tree 印刷 在这些诊断之上提供/注入树。

vp run vize:lint:cross-file
vp run vize:lint:cross-file-tree

较低层级的跨文件引擎比当前的CLI表面更宽泛：

其指导原则是默认保持单文件linting快速，明确暴露跨文件组，如下 它们成熟，并将高置信度项目事实导入与 CLI、Oxlint 桥接器和编辑器服务器。

类型检查

vize check为Vue SFC生成虚拟TypeScript，并请求Corsa项目会话 诊断。它检查.vue、.ts、.tsx和.d.ts输入，并将诊断映射回 原始源文件。

{
  "scripts": {
    "vize:check": "vize check",
    "vize:check:src": "vize check src",
    "vize:check:app": "vize check --tsconfig tsconfig.app.json",
    "vize:check:json": "vize check --format json --quiet",
    "vize:check:virtual-ts": "vize check --show-virtual-ts src/components/App.vue",
    "vize:check:profile": "vize check --profile src",
    "vize:check:single-server": "vize check --servers 1 src",
    "vize:check:declarations": "vize check --declaration --declaration-dir dist/types"
  }
}

vp run vize:check
vp run vize:check:src
vp run vize:check:app
vp run vize:check:json

当没有路径时，vize check读取tsconfig.json files、include和exclude 如果有项目配置可用，则填写字段。调试生成代码时使用--show-virtual-ts --profile需要时序和虚拟文件伪影时node_modules/.vize。

vp run vize:check:virtual-ts
vp run vize:check:profile
vp run vize:check:single-server

声明输出可从具体化检查器项目获得：

vp run vize:check:declarations

项目范围的模板值和生成的声明文件应通过TypeScript可见 项目配置。把环境声明放在你tsconfig的路径下，然后通过 需要时，该项目文件发送给检查器：

{
  "include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue", "src/**/*.d.ts"]
}

// src/types/vue-app.d.ts
declare module "vue" {
  interface ComponentCustomProperties {
    $t: (key: string) => string;
    $route: { path: string };
  }
}

vp run vize:check:app

npm 包脚本 vs Rust CLI

npm vize 包用于包脚本，使用打包的 NAPI 绑定：

{
  "scripts": {
    "vize:lint": "vize lint src",
    "vize:check": "vize check src --strict",
    "vize:ready": "vize ready src"
  }
}

vp run vize:lint
vp run vize:check
vp run vize:ready

Rust CLI 目前拥有更完整的项目支持类型检查表面：

nix run github:ubugeeei-prod/vize#vize -- check --tsconfig tsconfig.app.json --profile src
vize check --tsconfig tsconfig.app.json --profile src
vize lsp

当你想在应用中安装可安装的工作流程时，可以使用 npm 包脚本。使用 Rust CLI，当 你需要check-server、集成集成电路（LSP）、IDE管理，或者Corsa支持的项目诊断路径 Vue和TypeScript文件。

牛茚

当你的团队已经运行Oxlint并希望在oxlint-plugin-vize 同一条命令：

vp install -D oxlint oxlint-plugin-vize
vp exec oxlint-vize -c .oxlintrc.json -f stylish src

{
  "plugins": ["vue"],
  "jsPlugins": ["oxlint-plugin-vize"],
  "settings": {
    "vize": {
      "preset": "essential",
      "helpLevel": "short"
    }
  },
  "rules": {
    "eqeqeq": "error",
    "vize/vue/require-v-for-key": "error",
    "vize/vue/no-v-html": "warn"
  }
}

收养之路

1. 向CI添加vize:lint:ci包脚本，如vize lint --preset essential src。

2. 正确性诊断结果干净后切换到happy-path或opinionated。

3. 在你的项目tsconfig.json中添加一个vize:check包脚本。

4. 先启用编辑器线条，然后在CI输出稳定后进行类型检查。

5. 为需要深入分析的项目添加跨文件和严格的反应性检查。

对于单一质量门，运行 vize ready src 的 vize:ready 包脚本会依次执行 `fmt

• -write、lint、check和build`，并在第一个失败的步骤停止。