【踩坑】GitHub Actions 运行的 Linux 环境中，文件名是大小写敏感的

在使用 VuePress 搭建个人博客并部署到 GitHub Pages 的过程中，我遇到了一个颇为棘手的问题：本地打包一切正常，但在 GitHub Actions 自动执行打包流程时，却提示找不到 README.md 文件，导致整个流程失败。经过一番深入排查和尝试，终于成功解决了这个问题，在此将整个过程记录下来，希望能帮助到遇到类似情况的开发者。

一、问题出现

我的 VuePress 项目在本地运行 npm run docs:build 时，一切都按预期进行，顺利生成了静态文件，并且我自定义的将根目录下的 README.md 文件复制到构建输出目录的操作也毫无问题。然而，当我将代码推送到 GitHub 仓库后，GitHub Actions 工作流启动，却在执行到复制 README.md 文件这一步时出错，日志中清晰地显示：

这让我十分困惑，因为 README.mdR 文件确实就存在于项目的根目录下，本地能正常识别，为何在 GitHub Actions 中就找不到了呢？

二、排查过程

（一）初步怀疑文件未正确检出

首先，我怀疑是 GitHub Actions 在检出代码时出现了问题，导致 README.md 文件没有被正确下载到运行环境中。我检查了工作流中的 actions/checkout 步骤，发现并没有明显的配置错误。不过，为了确保完整检出仓库历史，我在该步骤中添加了 fetch-depth: 0 参数，重新推送代码触发工作流，结果问题依旧存在。

（二）考虑路径差异

接着，我意识到本地和 GitHub Actions 的运行环境可能存在路径差异。在本地开发时，我习惯了特定的文件路径结构，但 GitHub Actions 运行在 Ubuntu 环境下，其工作目录可能与我预期的不同。为了验证这一点，我在复制文件的 copy-readme.js 脚本中添加了打印当前工作目录的语句：

console.log('当前工作目录:', __dirname);

重新运行工作流后，从日志中看到工作目录为 /home/runner/work/vivien-blog-code/vivien-blog-code，这与预期相符，说明路径结构本身没有问题。

（三）关注分支情况

我又想到可能是分支的问题。也许我在本地测试时使用的分支和 GitHub Actions 触发工作流的分支不一致，而 README.md 文件只存在于我本地测试的分支中。仔细检查了工作流配置中的 on.push.branches 字段，发现配置的正是我本地使用的 main 分支，排除了分支不一致的可能性。

（四）检查缓存及权限

考虑到缓存可能带来的影响，我在工作流中添加了清除 node_modules 缓存的步骤，重新运行后问题仍然没有解决。同时，我也检查了文件权限，在复制文件前添加了设置文件权限的命令 chmod -R 755.，但依旧未能成功。

（五）发现文件名大小写问题

在几乎排查了所有可能的常规问题后，我突然想到在 Linux 环境下文件名是大小写敏感的。我仔细检查了本地的 README.md 文件，发现文件名中的 .md 部分实际上是大写的，即 README.MD。而我的 copy-readme.js 脚本和 package.json 中的构建脚本都是按照 README.md
来查找文件的，这很可能就是问题的根源！