Summary
Cloning the repository on Windows completes successfully, but the checkout fails because one of the blog asset filenames contains the * character, which is not supported on Windows (NTFS).
Environment
- OS: Windows 11
- Git: Git for Windows (OpenSSH)
- Filesystem: NTFS
Steps to Reproduce
- Clone the repository:
git clone https://github.com/prisma/web.git
- Wait for the checkout to complete.
Actual Behavior
Git downloads the repository successfully, but fails during checkout with the following error:
error: invalid path 'apps/blog/public/connections-edges-nodes-in-relay-758d358aa4c7/imgs/0*sPafc6eXHJvRSJhZ.png'
fatal: unable to checkout working tree
warning: Clone succeeded, but checkout failed.
Expected Behavior
The repository should clone and check out successfully on Windows without requiring any additional configuration.
Root Cause
The filename:
apps/blog/public/connections-edges-nodes-in-relay-758d358aa4c7/imgs/0*sPafc6eXHJvRSJhZ.png
contains the * character.
While this is a valid filename on Unix-like systems, Windows (NTFS) does not allow the following characters in filenames:
As a result, Git cannot create the file during checkout and aborts the working tree checkout.
Additional Notes
- The repository downloads successfully; only the checkout fails.
- I was able to continue working using GitHub Codespaces, where the repository checks out without issues.
- Renaming this asset to a Windows-compatible filename should resolve the problem for Windows contributors.
Summary
Cloning the repository on Windows completes successfully, but the checkout fails because one of the blog asset filenames contains the
*character, which is not supported on Windows (NTFS).Environment
Steps to Reproduce
Actual Behavior
Git downloads the repository successfully, but fails during checkout with the following error:
Expected Behavior
The repository should clone and check out successfully on Windows without requiring any additional configuration.
Root Cause
The filename:
contains the
*character.While this is a valid filename on Unix-like systems, Windows (NTFS) does not allow the following characters in filenames:
As a result, Git cannot create the file during checkout and aborts the working tree checkout.
Additional Notes