Electron中fs.existsSync无法识别含拉丁字符的文件名问题

核心问题排查 #

你的代码同时混用了path.join和手动路径拼接（${endpath}/${detail.name}），这种方式会干扰路径的编码处理逻辑，再加上部分拉丁字符的编码一致性问题，最终导致fs模块无法正确匹配文件。

具体解决步骤 #

1. 规范路径拼接方式 #

不要将endpath和detail.name手动拼接成字符串后传入path.join，而是把它们作为独立参数传入，让path.join自动处理路径分隔符和编码：

const localDownloadPath = path.join(app.getPath('userData'), endpath, detail.name);
if (fs.existsSync(localDownloadPath)) {
  return true;
} else {
  return false;
}

2. 确保文件名编码一致 #

如果detail.name是从外部（如API、文件列表）获取的，可能存在URI编码情况，先解码再使用：

const decodedFileName = decodeURIComponent(detail.name);
const localDownloadPath = path.join(app.getPath('userData'), endpath, decodedFileName);

3. 替换为更可靠的文件检查API #

fs.existsSync属于遗留API，推荐使用fs.promises.access检查文件存在性，它能提供更准确的错误信息（如权限问题、路径无效等）：

const checkFileExists = async (filePath) => {
  try {
    await fs.promises.access(filePath, fs.constants.F_OK);
    return true;
  } catch {
    return false;
  }
};

// 调用示例
const localDownloadPath = path.join(app.getPath('userData'), endpath, detail.name);
return await checkFileExists(localDownloadPath);

4. 针对Windows系统的额外处理 #

如果是Windows环境，部分区域设置会影响非ASCII字符的识别，可在Electron主进程启动时设置UTF-8环境变量：

// main.js开头添加
process.env.LANG = 'en_US.UTF-8';
process.env.CODEPAGE = '65001'; // UTF-8代码页

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