Tweak the wording on DOTNET_HOST_PATH docs to align with the new world #49422
+3
−8
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
In .NET 10 / VS2026 we have a new invariant for DOTNET_HOST_PATH in builds that we should document
There was a problem hiding this comment.
Pull Request Overview
This PR updates the documentation for the DOTNET_HOST_PATH environment variable to reflect new behavior in .NET 10 / Visual Studio 2026. The key change is that MSBuild in Visual Studio 2026 will now guarantee that DOTNET_HOST_PATH is set for all builds of .NET SDK projects, representing a shift in how this environment variable should be used.
Key Changes:
- Expanded the description to clarify that
DOTNET_HOST_PATHapplies both to running processes and to MSBuild build scenarios - Removed the conditional algorithm for locating
dotnet(previously advising fallback to PATH) - Added guidance that MSBuild tools should expect
DOTNET_HOST_PATHto be set and may emit diagnostics when missing
Co-authored-by: Copilot <[email protected]>
Co-authored-by: Copilot <[email protected]>
gewarren
approved these changes
Oct 22, 2025
Co-authored-by: Genevieve Warren <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>
agocke
reviewed
Oct 23, 2025
| - if `DOTNET_HOST_PATH` is set, use that value directly | ||
| - otherwise, rely on `dotnet` via the system's `PATH` | ||
|
|
||
| > [!NOTE] |
There was a problem hiding this comment.
Keep this. You cannot rely on DOTNET_HOST_PATH being set unless you were launched from the SDK
agocke
requested changes
Oct 23, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
In .NET 10 / VS2026 we have a new invariant for DOTNET_HOST_PATH in builds that we should document.
Internal previews