Skip to content

Performance difference between Vale 3.19.0 and 3.27.0 #1233

Closed

Description

@jtiee

I recently upgraded Vale from 3.19.0 to 3.27.0, to acquire the change in 3.26.0:

bd1c0ba fix: An ignored class covers an image's alt text

After the upgrade, I noticed Vale processes notably slower:

$ vale-3.19.0 --version
vale version 3.19.0
$ time vale-3.19.0 --config vale/vale.ini build
...snip...
✖ 0 errors, 10 warnings and 0 suggestions in 3337 files.

real    1m33.855s
user    7m38.498s
sys     0m3.764s
$ vale-3.27.0 --version
vale version 3.27.0
$ time vale-3.27.0 --config vale/vale.ini build
...snip...
✖ 0 errors, 1 warning and 0 suggestions in 3337 files.

real    8m30.204s
user    42m5.646s
sys     0m7.045s

The runs were consecutive, on a Macbook Pro M1 MAX, 32GB memory, macOS 27.2, on the same set of HTML files and styles.

The HTML is generated by Antora, but I cannot share the content.

We use custom styles derived from the Google style you provide. Here's my vale.ini:

StylesPath = .
MinAlertLevel = warning # suggestion, warning or error

# Classes to ignore
IgnoredClasses = ask, blurb, button, thanks-label, metrics-label, metrics-value, vale-off, pagination

# Style packages
Packages = Google, \
https://github.com/.../styles.zip

# Only HTML files; change to whatever you're using.
[*.html]

# List of styles to load.
BasedOnStyles = Google, MyStyles, Vale

# Style.Rule = {YES, NO, suggestion, warning, error} to
# enable/disable a rule or change its level.
Vale.Repetition = NO
Vale.Spelling = NO
Google.Colons = NO
Google.FirstPerson = NO
Google.Headings = NO
Google.OptionalPlurals = NO
Google.OxfordComma = NO
Google.We = NO
Google.WordList = NO
Google.WordListCase = NO

There is a difference in warning count because 3.19.0 was enable to ignore image alt text, whereas 3.27.0 can.

Let me know if you need more information.

Activity

  1. jdkato commented on Nov 20, 2026

    @jdkato
    Member

    Thanks for the report and the config: it was enough to reproduce this.

    Fixed in fbab1cc: the lists are now built per file, and whether text sits inside an ignored container is tracked as elements open and close. On 2,000 deeply nested HTML pages with eight ignored classes, linting went from 71 seconds to 1.4 seconds, with identical results.

    The fix will ship in the next release. Please reopen this if your build is still slower than it was on 3.19.0.

  2. jtiee commented on Nov 20, 2026

    @jtiee
    Author

    Thanks for the quick fix! I look forward to the next release.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions