如何在VS Code远程会话中调试NAS上的PowerShell脚本（无需重复打开）

1. 先搞定NAS路径的远程映射问题 #

核心问题是你当前打开的文件路径和远程机器（NAS）识别的路径不匹配，PSedit是从远程会话视角打开文件，路径完全对应，所以能正常调试。首先要让VS Code远程会话里的文件路径，和远程机器访问NAS的路径完全一致：

• 在远程机器上，用New-PSDrive或者SMB映射，把NAS的共享目录挂载成远程机器的本地路径（比如Z盘，或者C:\NAS-Scripts这类本地目录）。
• 之后在VS Code远程会话里，直接从这个挂载后的本地路径打开脚本，不要从NAS的网络共享路径打开。

2. 配置launch.json实现直接调试 #

打开VS Code调试面板（快捷键Ctrl+Shift+D），点击「创建launch.json文件」选择PowerShell，替换成以下配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "远程调试NAS脚本",
            "type": "PowerShell",
            "request": "launch",
            "script": "${file}",
            "args": [],
            "cwd": "${fileDirname}",
            "remote": true,
            "executionPolicy": "RemoteSigned",
            "noProfile": false
        }
    ]
}

关键配置说明： #

• ${file}：直接调用当前打开的文件，只要路径和远程机器的本地挂载路径一致，就能直接调试，不用再用PSedit重新打开。
• remote: true：明确告诉PowerShell扩展这是远程调试场景。
• cwd: "${fileDirname}"：确保调试时的工作目录和脚本所在目录一致，避免路径相关错误。

3. 验证路径匹配性 #

打开脚本后，右键文件选择「复制路径」，在远程会话的PowerShell终端里执行Test-Path "<复制的路径>"，如果返回True，说明路径完全匹配，断点就能正常生效。

4. 实现启动自动打开所有脚本 #

把NAS挂载后的目录添加到VS Code工作区：

• 在远程会话里，点击「文件→打开文件夹」，选择挂载后的NAS目录。
• 执行「文件→将工作区另存为」，保存成.code-workspace文件。
• 下次启动VS Code远程会话时，直接打开这个工作区文件，所有脚本会自动加载，直接就能设置断点调试。

常见问题排查 #

• 断点灰色不生效：检查远程机器是否能访问脚本路径，NAS挂载是否正常。
• 权限报错：在远程会话的PowerShell里用管理员权限执行Set-ExecutionPolicy RemoteSigned，允许执行远程脚本。

内容的提问来源于stack exchange，提问作者Besugo