如何修改VS Code调试Next.js项目时传递的目录大小写？

问题背景 #

在VS Code中调试Next.js项目时，使用以下launch.json配置：

{
    // ...
    "configurations": [
        {
            "name": "Frontend: Dev Server",
            "request": "launch",
            "runtimeArgs": [
                "run-script",
                "dev",
                "--preserve-symlinks", // To debug linked
            ],
            "runtimeExecutable": "npm",
            "skipFiles": [
                "<node_internals>/**"
            ],
            "type": "node",
            
        }
    ],
}

运行调试配置时出现路径大小写警告：

C:\Program Files\nodejs\npm.cmd run-script dev --preserve-symlinks
> web-client@0.1.0 dev
> next dev -p 5555
warn  - Invalid casing detected for project dir, received c:\etcetc actual path C:\etcetc

已尝试通过code C:\etcetc直接打开项目，但未找到相关设置选项。

解决方案 #

1. 在launch.json中指定大写盘符的工作目录 #

在调试配置里添加cwd字段，明确指定大写盘符的项目路径，强制VS Code使用正确的路径大小写启动调试：

{
    // ...
    "configurations": [
        {
            "name": "Frontend: Dev Server",
            "request": "launch",
            "runtimeArgs": [
                "run-script",
                "dev",
                "--preserve-symlinks"
            ],
            "runtimeExecutable": "npm",
            "skipFiles": [
                "<node_internals>/**"
            ],
            "type": "node",
            "cwd": "C:\\etcetc" // 替换为你的大写盘符项目路径，注意转义反斜杠
            // 也可以用正斜杠写法："cwd": "C:/etcetc"
        }
    ],
}

2. 修改package.json中的dev脚本，指定项目目录 #

在package.json的scripts里，给next dev命令加上--dir参数，固定使用大写盘符的路径启动项目：

{
  "name": "web-client",
  "version": "0.1.0",
  "scripts": {
    "dev": "next dev -p 5555 --dir C:\\etcetc" // 替换为你的实际项目路径
  }
}

这样无论VS Code传递什么路径，Next.js都会使用你指定的正确大小写路径启动。

3. 规范VS Code项目打开方式 #

确保始终通过大写盘符路径打开项目：

• 打开命令提示符，进入C:\etcetc目录后执行code .
• 或在VS Code中通过文件 > 打开文件夹，选择目录时确认路径显示为大写盘符

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