RemotePathMap

[
  {
    "remoteAuthority": "ssh-remote+dev-server",
    "remoteWorkspaceFolder": "/srv/project",
    "localWorkspaceFolder": "D:\\mirror\\project",
    "description": "可选说明"
  }
]

RemotePathMap is a VS Code UI extension that runs locally. It maps remote SSH or WSL workspace paths to local folders and lets you reveal the mapped local file or folder from Explorer.

Problem Solved

In Remote SSH or WSL windows, the built-in Reveal in File Explorer action often cannot locate the corresponding path on the local machine. If you already mirror, mount, or sync the remote project to a local directory, this extension adds a usable Explorer context action for that local path.

How It Works

• The extension runs as a UI extension on the local side.
• Explorer context menu entries appear only for remote resources.
• The command is available from both Explorer context menus and editor tab context menus.
• Mappings are matched by remote authority plus remote workspace root path.
• When a matching mapping exists, the context menu shows Reveal in File Explorer [Mapped].
• When the mapped target is a file, Windows and macOS try to reveal and select the file in the system file manager; when it is a directory, the directory is opened directly.
• When no mapping is configured yet, the context menu shows Reveal in File Explorer [Setup Required], then guides you through remote path and local path setup.

Settings

remotePathMap.workspaceMappings

Mappings for the current remote workspace folder. Use this when a mapping should apply only to that workspace folder.

remotePathMap.globalMappings

Mappings stored in local user settings on this machine. Use this when the same remote authority and remote root should be reused across multiple workspaces.

Mapping Shape

[
  {
    "remoteAuthority": "ssh-remote+dev-server",
    "remoteWorkspaceFolder": "/srv/project",
    "localWorkspaceFolder": "D:\\mirror\\project",
    "description": "Optional note"
  }
]

VS Code reliably exposes the remote authority, for example ssh-remote+host-alias or wsl+distribution. It does not always expose the raw IP, so global mappings use authority plus remote workspace root as the matching key.

Local Path Selection

During mapping setup, the extension first asks for the remote root path and then for the local root path. This allows you to map the current workspace folder, a subdirectory, or the entire remote root such as /.

In some remote windows, the folder picker may return a remote URI instead of a local file-system path. To prevent a remote path from being stored as a local mapping, RemotePathMap provides two ways to enter the local root:

• Browse local folder
• Enter the local absolute path manually

If the picker does not return a local path, the extension prompts you to switch to manual input.

Debugging

1. Run npm install.
2. Press F5 and choose 运行 RemotePathMap 扩展.
3. In the Extension Development Host window, open a Remote SSH or WSL workspace and verify the Explorer context menu flow.

Testing

Run npm test to execute the path mapping unit tests.

Packaging And Publishing

• Run npm run package:extension to generate a VSIX package.
• Run npm run publish:extension to publish the extension to the Marketplace.