docs(ssr): note linked deps no external (#9708)

vitejs · Aug 16, 2022 · 095e920 · 095e920
1 parent 6e58d9d
commit 095e920
Showing 1 changed file with 2 additions and 0 deletions.
diff --git a/docs/guide/ssr.md b/docs/guide/ssr.md
@@ -213,6 +213,8 @@ Dependencies are "externalized" from Vite's SSR transform module system by defau
 
 If a dependency needs to be transformed by Vite's pipeline, for example, because Vite features are used untranspiled in them, they can be added to [`ssr.noExternal`](../config/ssr-options.md#ssr-noexternal).
 
+For linked dependencies, they are not externalized by default to take advantage of Vite's HMR. If this isn't desired, for example, to test dependencies as if they aren't linked, you can add it to [`ssr.external`](../config/ssr-options.md#ssr-external).
+
 :::warning Working with Aliases
 If you have configured aliases that redirects one package to another, you may want to alias the actual `node_modules` packages instead to make it work for SSR externalized dependencies. Both [Yarn](https://classic.yarnpkg.com/en/docs/cli/add/#toc-yarn-add-alias) and [pnpm](https://pnpm.js.org/en/aliases) support aliasing via the `npm:` prefix.
 :::