解决dotnet-script调试配置问题的技术指南

2025-06-27 08:05:26作者：瞿蔚英Wynne

「dotnet-script」让C#脚本开发轻而易举！无需复杂配置，在VS Code中直接编辑和调试，享受OmniSharp提供的语言服务支持。支持.NET 6.0、7.0、8.0框架，一键安装，跨平台可用。只需编写简单代码如`Console.WriteLine("Hello world!");`，即刻执行。内置NuGet包管理，轻松引用所需库。立即加入，提升你的C#脚本开发效率！

项目地址：https://gitcode.com/gh_mirrors/dot/dotnet-script

问题背景

在使用dotnet-script进行脚本调试时，开发者可能会遇到VS Code默认生成的launch.json配置文件无法正常工作的问题。具体表现为当尝试启动调试会话时，系统提示找不到指定的dotnet-script命令或文件。

问题现象

默认情况下，dotnet-script初始化生成的launch.json配置如下：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": ".NET Script Debug",
      "type": "coreclr",
      "request": "launch",
      "program": "${env:HOME}/.dotnet/tools/dotnet-script",
      "args": ["${file}"],
      "windows": {
        "program": "${env:USERPROFILE}/.dotnet/tools/dotnet-script.exe",
      },
      "cwd": "${workspaceFolder}",
      "stopAtEntry": false,
    }
  ]
}

执行时会报错，提示无法找到dotnet-script命令或文件。错误信息表明系统无法识别或定位到dotnet-script工具。

根本原因分析

这个问题通常源于以下几个可能的原因：

路径解析问题：VS Code可能无法正确解析${env:HOME}环境变量
工具安装位置变更：不同版本的.NET SDK可能将全局工具安装在不同的位置
权限问题：执行权限可能未正确设置
环境变量未更新：PATH环境变量可能未包含工具所在目录

解决方案

开发者提供了一个有效的替代配置方案：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Script Debug",
            "type": "coreclr",
            "request": "launch",
            "program": "${env:DOTNET_ROOT}/tools/.store/dotnet-script/1.6.0/dotnet-script/1.6.0/tools/net9.0/any/dotnet-script.dll",
            "args": [
                "${file}"
            ],
            "windows": {
                "program": "${env:USERPROFILE}/.dotnet/tools/dotnet-script.exe",
            },
            "cwd": "${workspaceFolder}",
            "stopAtEntry": false,
        }
    ]
}