Error AtlasError Documentation and Resolution
Back to searchMore Vite errors

Vite

Vite does not detect file changes under WSL2

Vite does not detect a file change.

Vite file watching can fail under WSL2 in certain filesystem conditions, preventing the dev server from noticing edits.

Vite does not detect a file changedevelopment servers

Observed message

Vite does not detect a file change.

Why it happens

  • The project is running under WSL2 in a file-watching scenario that does not propagate changes reliably.
  • Filesystem boundaries or mount behavior interfere with watcher events.
  • The default watch strategy is not suitable for the current WSL2 setup.

How to fix it

  1. Review Vite's `server.watch` settings for the WSL2 environment.
  2. Use a filesystem location that supports reliable file watch events.
  3. Adjust the watcher strategy if your development setup requires polling or different watch behavior.

Official reference

Vite: Troubleshooting

Related errors

Error: Cannot find module 'C:\foo\bar&baz\vite\bin\vite.js'Vite cannot start because the project path contains an ampersand on WindowsCross drive links on WindowsVite cross-drive links do not work on WindowsPort 5173 is already in useVite dev server port already in useRequests are stalled foreverVite dev server requests are stalled forever

Explore more

ViteBrowse more Vite errorsdevelopment serversBrowse more development servers errors
Vite does not detect file change in WSL2: causes and fixes | Error Atlas