使用git clone一个仓库怎么也克隆不成功，一查原因竟是windows系统下不能创建某些文件(夹)。

重现问题

执行git clone xxx报以下错误。

fatal: cannot create directory at 'CON': Invalid argument
warning: Clone succeeded, but checkout failed.
You can inspect what was checked out with 'git status'
and retry the checkout with 'git checkout -f HEAD'


按照指示执行git checkout -f HEAD依然报下列错误。

fatal: cannot create directory at 'CON': Invalid argument

问题分析

由于git clone操作会将远程仓库文件下载到本地，如果远程仓库存在CON文件，导致git创建不了windows系统保留的关键词，导致克隆失败。
本地试了一下创建一个CON文件结果报以下错误：



问题解决

将远程仓库的CON文件重命名即可解决问题。

总结

避免创建windows系统保留的文件名字。
从微软官方文档找到以下不可使用的预留名称:

CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9。
同时还要避免这些名称后面紧跟着一个扩展名。

https://docs.microsoft.com/zh-cn/windows/win32/fileio/naming-a-file

关于更多

Qt君公众号后台回复"git"获取更多相关信息。

windows不文件命名规则是：在文件名或文件夹名中，最多可以有255个字符。其中包含驱动器和路径名。不能出现以下字符：

\ / : * ? " < > →

import re

filenemae = "<aaaaaaaaa/"
file = re.sub(r'[\/:*?"<>|]', " ", filenemae)
print(file)

使用git clone一个仓库怎么也克隆不成功，一查原因竟是windows系统下不能创建某些文件(夹)。
重现问题
执行git clone xxx报以下错误。
fatal: cannot create directory at 'CON': Invalid argument
warning: Clone succeeded, but checkout failed.
You can inspect what was checked out with 'git status'
and retry the checkout with 'git checkout -f HEAD'
按照指示执行git checkout -f HEAD依然报下列错误。
fatal: cannot create directory at 'CON': Invalid argument
问题分析
由于git clone操作会将远程仓库文件下载到本地，如果远程仓库存在CON文件，导致git创建不了windows系统保留的关键词，导致克隆失败。
本地试了一下创建一个CON文件结果报以下错误：
问题解决
将远程仓库的CON文件重命名即可解决问题。
总结
避免创建windows系统保留的文件名字。
从微软官方文档找到以下不可使用的预留名称:
CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9。
同时还要避免这些名称后面紧跟着一个扩展名。
https://docs.microsoft.com/zh-cn/windows/win32/fileio/naming-a-file
关于更多
Qt君公众号后台回复"git"获取更多相关信息。
​

写在前面


windows文件或文件夹命名包含以上任何字符时会报错，所以使用python做爬虫或其它项目时需要注意保存文件名不能包含这些字符。如果有的话，请用字符串的replace方法替换为空。
测试样例
https://img-blog.csdnimg.cn/20201116003919682.jpg


下载代码
import requests
url = 'https://img-blog.csdnimg.cn/20201116003919682.jpg'
name = 'test<*?.jpg'
sets = ['/', '\\', ':', '*', '?', '"', '<', '>', '|']
for char in name:
    if char in sets:
        name = name.replace(char, '')
res = requests.get(url)
with open(name, 'wb') as f:
    f.write(res.content)

代码分析
假如我们通过爬虫获取到了很多张图片的链接和名字，但是名字不知道是否包含有windows命名所不支持的特殊字符，因此下载保存图片之前需要对文件名进行处理，将不支持的字符替换为空：
name = 'test<*?.jpg'
sets = ['/', '\\', ':', '*', '?', '"', '<', '>', '|']
for char in name:
    if char in sets:
        name = name.replace(char, '')

注：\在python中是转义字符，所以如果想表示\必须用\\。
温馨提示


windows对于文件或文件夹的命名大小写不敏感。举个栗子：同一目录下，不能同时存在a.txt和A.txt两个文件。因此，下载保存文件时除了不能包含一些特殊字符外也要注意大小写问题。当然，这不是python的问题，而是windows系统的问题，所以用其它编程语言应该也会遇到同样的问题。