React项目部署GitHub Pages报错：'.'未被识别为内部命令

问题原因 #

你遇到的错误是因为Windows环境下不识别./类的POSIX路径写法，且直接通过相对路径调用node_modules内的命令并非跨平台的最优方式；若node_modules与package.json不在同一目录，路径写法也需要调整。

修复方案 #

方案1：利用npm脚本自动查找命令（推荐） #

npm会自动在项目的node_modules/.bin目录下检索可执行命令，无需手动写完整路径，直接修改脚本：

"scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject",
    "publicar": "npm run build && gh-pages -d build"
  },

该写法兼容Windows、Linux、macOS所有系统，npm会自动定位到gh-pages的执行文件。

方案2：用npx调用（适配node_modules不在同目录的场景） #

如果node_modules确实和package.json不在同一层级，用npx自动处理模块查找逻辑：

"scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject",
    "publicar": "npm run build && npx gh-pages -d build"
  },

只要项目依赖中安装了gh-pages，npx就能自动找到并执行它。

方案3：直接调用node执行脚本（针对Windows路径兼容） #

如果一定要写完整路径，可直接调用node执行gh-pages的源码文件，避免shell路径识别问题：

"scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject",
    "publicar": "npm run build && node ./node_modules/gh-pages/bin/gh-pages.js -d build"
  },

验证步骤 #

1. 先确保已安装gh-pages依赖：

npm install gh-pages --save-dev

2. 执行npm run publicar，正常情况下会先完成项目构建，再将build目录部署到GitHub Pages，最终输出Published提示。

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