Netlify克隆仓库失败：Git报文件名过长，寻求非缩短文件名的解决办法

以下是无需直接修改原文件名的可行方案：

1. 自定义Netlify克隆命令（优先推荐） #

Netlify允许通过环境变量指定带参数的克隆命令，以此启用Git长文件名支持：

• 进入Netlify项目的「Site settings」→「Build & deploy」→「Environment variables」
• 添加环境变量：
  • 变量名：GIT_CLONE_COMMAND
  • 变量值：git clone --config core.longpaths=true --filter=blob-none https://github.com/QuaCau-TheSphere/OPT-web-netlify
    该命令会在克隆仓库时强制启用长文件名支持，绕过系统的文件名长度限制。

2. 仓库内添加Git配置文件 #

在仓库根目录创建.gitconfig文件，写入以下内容并提交到远程仓库：

[core]
    longpaths = true

Netlify克隆仓库时会自动应用此配置，允许创建长文件名文件。

3. MkDocs别名重定向（需先解决克隆问题） #

如果上述方法无法生效，可结合MkDocs的重定向插件为长文件名文件设置短路径别名，避免后续构建路径问题：

1. 安装插件：pip install mkdocs-redirects
2. 在mkdocs.yml中配置：

plugins:
  - redirects:
      redirect_maps:
        "short/ai-lowcode.md": "⚡Hiểu biết sâu/Khoa học máy tính/Đánh đổi/Lập trình viên khó chịu với hệ thống low code không phải vì nó ưu tiên sự tiện lợi và chi phí thấp cho người dùng, mà vì nó được tiếp thị như là một giải pháp hoàn hảo có thể giải quyết được mọi nhu cầu thực tế.md"
        "short/anthropology-dialogue.md": "⚡Hiểu biết sâu/Nhân học/Diễn giải và mô tả/Diễn giải/Một phần quan trọng của sự kiến tạo cuộc đá gà thành một văn bản là một quá trình hội thoại và đối mặt với một số người Bali chứ không phải là việc đọc và diễn giải văn hóa đằng sau lưng họ.md"
        # 其他长文件名文件的别名映射

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