Skip to content

Commit c9a35ea

Browse files
committed
doc: add a tip about developer mode on Windows
On Windows, creating symlinks requires Developer Mode to be enabled or running the command as Administrator. Tests that rely on creating symlinks may fail with EPERM errors if symlink creation is not permitted. Add a tip about this for the docs about running tests on Windows.
1 parent dcb9573 commit c9a35ea

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

BUILDING.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -870,6 +870,12 @@ To test if Node.js was built correctly:
870870
Release\node -e "console.log('Hello from Node.js', process.version)"
871871
```
872872

873+
> \[!TIP]
874+
> On Windows, creating symlinks requires [Developer Mode][] to be enabled or
875+
> running the command as Administrator. Tests that rely on creating symlinks
876+
> may fail with EPERM errors if symlink creation is not permitted.
877+
> ```
878+
873879
##### Using ccache:
874880
875881
Follow <https://github.com/ccache/ccache/wiki/MS-Visual-Studio>, and you
@@ -1140,4 +1146,5 @@ by opening a pull request against the registry available at
11401146
<https://github.com/nodejs/node/blob/HEAD/doc/abi_version_registry.json>.
11411147

11421148
[AIX toolbox]: https://www.ibm.com/support/pages/aix-toolbox-open-source-software-overview
1149+
[Developer Mode]: https://learn.microsoft.com/en-us/windows/advanced-settings/developer-mode
11431150
[Python versions]: https://devguide.python.org/versions/

0 commit comments

Comments
 (0)