部署Docusaurus到GitHub Pages时遇错误：找不到package.json文件

问题根源 #

执行部署命令时yarn找不到package.json，本质是当前终端所在目录不是Docusaurus项目的根目录，或者你输入的路径存在错误（比如你写的K:(repository directory明显路径不完整）。

具体解决步骤 #

• 切换到正确的项目根目录
  打开终端，用cd命令进入你的Docusaurus项目文件夹，示例：

  cd K:\你的Docusaurus项目完整路径
  

  切换完成后，用dir（Windows系统）或ls（Mac/Linux系统）命令查看当前目录，确认存在package.json文件。

• 修正部署命令格式
  把命令里的<GITHUB_USERNAME>替换成你真实的GitHub用户名，同时去掉尖括号：

  GIT_USER=你的GitHub用户名 yarn deploy
  

  如果你用的是Windows系统，环境变量写法要调整为PowerShell兼容格式：

  $env:GIT_USER="你的GitHub用户名"; yarn deploy
  

• 额外验证项

  • 检查docusaurus.config.js配置：url需设为https://你的GitHub用户名.github.io，baseUrl设为/你的仓库名称/（针对用户个人仓库）
  • 确认本地仓库已关联GitHub远程仓库，执行git remote -v查看输出，未关联的话用git remote add origin git@github.com:你的GitHub用户名/你的仓库名称.git添加关联

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