在运行`json-server --watch`时遇到意外的错误和警告。

Question

我正在尝试使用 json-server，命令如下：

$ json-server --watch db.json

但在执行该命令时，根据安装的版本不同，遇到了一些错误或警告：

对于 1.0.0-alpha.1 到 1.0.0-alpha.12 版本：

在 Unix/Linux/macOS 系统中：

    sh: json-server: command not found

在 Windows 系统中：

    The term 'json-server' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
    At line:1 char:1
    + json-server --watch db.json

如果通过 npx 执行：

    npm ERR! could not determine executable to run

对于 1.0.0-alpha.13 版本：

  node:internal/errors:496
      ErrorCaptureStackTrace(err);
      ^

  TypeError [ERR_PARSE_ARGS_UNKNOWN_OPTION]: Unknown option '--watch'. To specify a positional argument starting with a '-', place it at the end of the command after '--', as in '-- "--watch"

对于 1.0.0-alpha.14 及以上版本：

  --watch/-w can be omitted, JSON Server 1+ watches for file changes by default

对于 1.0.0-alpha.13 及以上版本，如果使用的 Node.js 版本早于 v18.3.0 或 v16.17.0：

  +, if using Node.js before v18.3.0, v16.17.0:
  import { parseArgs } from 'node:util';
           ^^^^^^^^^
  SyntaxError: The requested module 'node:util' does not provide an export named 'parseArgs'



最小化的 package.json 文件（根据需要更新 json-server 的版本）如下：

{
  "name": "q77787616",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "start": "json-server --watch db.json"
  },
  "keywords": [],
  "license": "ISC",
  "dependencies": {
    "json-server": "1.0.0-alpha.12"
  }
}

ekhumoro · Answer

json-server 正在积极开发其 V1 版本，但遗憾的是，这些 alpha 版本被发布到了 npm 上并被打上了 latest 标签，因此如果你只是执行 npm install json-server，它们会被优先安装，而非稳定版本（当前为 0.17.4）。这导致了多种问题：

在 alpha.13 之前的版本中，正确的可执行文件根本就没有安装，因此无法找到 json-server 命令（参见 typicode/json-server#1472）。

针对 alpha.13，虽然包含了可执行文件，但是命令行界面（CLI）发生了变化，导致 --watch 成为了无效的参数（参见 typicode/json-server#1474）：

  $ npx json-server@1.0.0-alpha.13 --help
  使用方法: json-server [选项] <文件>
  选项:
    -p, --port <端口>  端口号（默认: 3000）
    -h, --host <主机>  主机名（默认: localhost）
    -s, --static <目录> 静态文件目录（允许多个）
    --help  显示此帮助信息

其中，参数解析由 Node.js v16.17 及 v18.3 中引入的来自 node:util 的 parseArgs 提供，因此早期版本的 Node.js 不受支持。

从 alpha.14 版本开始，虽然支持 --watch，但它已成为非必需参数，因此该消息被降级为警告信息。

你可以通过以下命令查看当前安装的版本：

npm ls json-server

鉴于目前的活跃开发和 alpha 测试状态，最好的做法是明确安装稳定版本（相关文档仍然可以在此处找到）：

$ npm install json-server@0

或者，如果你想要使用 alpha V1 版本，并且你的 Node.js 版本合适（即 ^16.17 || >=18.3），你可以执行 npm install json-server@latest 来获取最新版本（确保至少是 alpha.14），并且在运行命令时不需要使用 --watch 标志：

$ json-server db.json

splattne · Answer

对于已存在的node_modules中的json-server@0.17.4，将不会提供直接更新的帮助。您需要先移除现有的node_modules文件夹，然后重新安装稳定版本的json-server。

执行以下命令来进行操作：

npm remove json-server
rm -rf node_modules
npm cache clean --force
npm install json-server@0.17.4

Jon Erickson · Answer

步骤 1：打开“命令提示符”（CMD）

步骤 2：在命令行中输入以下命令并回车以全局安装 json-server 的特定稳定版本（0.17.4）：

npm install -g json-server@0.17.4

步骤 3：安装完成后，输入以下命令启动 json-server，并让它监听 db.json 文件的更改：

json-server --watch db.json

来源：typicode/json-server 的 v0 分支文档

Michael Borgwardt · Answer

首先，确认已安装包的版本。如果你正在使用 1.0.0-alpha.23 版本，那么无需添加 --watch 参数。另外，你需要在项目的 根目录 下创建一个名为 db.json 的文件。在成功创建该文件之后，可以使用以下命令：

json-server db.json