60cce66993
Tests / test (push) Has been cancelled
导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
178 lines
6.1 KiB
Python
178 lines
6.1 KiB
Python
# -*- coding: utf-8 -*-
|
||
r"""Windows 超长路径(MAX_PATH 260)兼容层 —— 纯标准库。
|
||
|
||
问题
|
||
----
|
||
Windows 默认把路径限制在 260 字符(MAX_PATH)。Unity 资源包解出来的目录树
|
||
本身就很深,例如::
|
||
|
||
Assets/NFD_Costume/HatsukoiVampire/Gimmick/Resource/Animator/
|
||
Animation/Toggle/Accessory/NeckRibbon/Accessory_NeckRibbon_ON.anim
|
||
|
||
再叠上「输出目录 / 文件名_日期_序号 / 文件名_extracted」这几层,很容易超过
|
||
260。一旦超出,open() / os.makedirs() 就抛::
|
||
|
||
FileNotFoundError: [Errno 2] No such file or directory: 'F:\...'
|
||
|
||
而且报错里那串路径看着完全正常,非常难排查。
|
||
|
||
注意:这**不是中文路径的问题**。Python 3 的 Unicode 路径本来就是好的,中文、
|
||
日文、空格、方括号、全角符号都没问题,纯粹是「总长度」超限。所以同一台机器
|
||
上路径浅就能转、路径深就报错,换台电脑因为存放位置不同结果又不一样。
|
||
|
||
绕过办法
|
||
--------
|
||
给路径加 ``\?\`` 前缀(Win32 扩展长度路径),直接跳过 MAX_PATH 检查。它
|
||
**不依赖**注册表 LongPathsEnabled,也不需要管理员权限或重启,所以在别人的
|
||
电脑上同样有效。
|
||
|
||
本模块把常用的文件 API 包一层:
|
||
* 路径短(< 240)→ 原样透传,行为和以前完全一致;
|
||
* 路径长 → 自动补 ``\?\``。
|
||
|
||
因此对现有用户零影响,只在「本来必然失败」的长路径上生效。
|
||
|
||
用法
|
||
----
|
||
``import longpath`` 即可,模块导入时自动安装(重复导入无副作用)。
|
||
"""
|
||
|
||
import builtins
|
||
import os
|
||
import os.path as _path
|
||
import shutil
|
||
|
||
# 文件路径上限 260、目录上限 248。这里留余量:超过 240 就上前缀,
|
||
# 免得刚好卡在 258 那种「有时行有时不行」的位置。
|
||
_THRESHOLD = 240
|
||
|
||
_PREFIX = '\\\\?\\' # \?\
|
||
_UNC_PREFIX = '\\\\?\\UNC\\' # \?\UNC\
|
||
|
||
_installed = False
|
||
_originals = {}
|
||
|
||
|
||
def long_path(path):
|
||
r"""路径过长时返回带 ``\?\`` 前缀的绝对路径;否则原样返回。
|
||
|
||
短路径一律原样返回(连 abspath 都不做),保证不改变任何现有行为。
|
||
"""
|
||
if os.name != 'nt':
|
||
return path
|
||
if not isinstance(path, str) or not path:
|
||
return path # 只处理 str;fd / PathLike 原样放行
|
||
if path.startswith(_PREFIX):
|
||
return path # 已经加过前缀,别重复加
|
||
if len(path) < _THRESHOLD:
|
||
return path # 短路径不碰
|
||
try:
|
||
p = _path.abspath(path)
|
||
except (OSError, ValueError):
|
||
return path
|
||
if len(p) < _THRESHOLD:
|
||
return path
|
||
if p.startswith('\\\\'):
|
||
# UNC:\\server\share\x → \?\UNC\server\share\x
|
||
return _UNC_PREFIX + p[2:]
|
||
return _PREFIX + p
|
||
|
||
|
||
def _install():
|
||
"""给 os / builtins / shutil 的相关函数套上长路径包装。幂等。"""
|
||
global _installed
|
||
if _installed or os.name != 'nt':
|
||
return
|
||
_installed = True
|
||
|
||
# ---- 单路径参数 ------------------------------------------------------
|
||
for name in ('makedirs', 'mkdir', 'rmdir', 'remove', 'unlink',
|
||
'stat', 'lstat', 'chmod', 'utime', 'listdir', 'scandir',
|
||
'access', 'truncate', 'readlink', 'startfile'):
|
||
fn = getattr(os, name, None)
|
||
if fn is None:
|
||
continue
|
||
_originals[name] = fn
|
||
|
||
def make(fn):
|
||
def wrapper(path, *a, **kw):
|
||
return fn(long_path(path), *a, **kw)
|
||
return wrapper
|
||
setattr(os, name, make(fn))
|
||
|
||
# ---- 双路径参数(源、目标都要处理)------------------------------------
|
||
for name in ('rename', 'replace'):
|
||
fn = getattr(os, name, None)
|
||
if fn is None:
|
||
continue
|
||
_originals[name] = fn
|
||
|
||
def make2(fn):
|
||
def wrapper(src, dst, *a, **kw):
|
||
return fn(long_path(src), long_path(dst), *a, **kw)
|
||
return wrapper
|
||
setattr(os, name, make2(fn))
|
||
|
||
# ---- 内置 open -------------------------------------------------------
|
||
_originals['open'] = builtins.open
|
||
|
||
def _open(file, *a, **kw):
|
||
return _originals['open'](long_path(file), *a, **kw)
|
||
builtins.open = _open
|
||
|
||
# ---- shutil:显式包一层(虽然底层最终也会走到上面的 open/stat)---------
|
||
for name in ('copyfile', 'copy', 'copy2', 'copymode', 'copystat',
|
||
'rmtree'):
|
||
fn = getattr(shutil, name, None)
|
||
if fn is None:
|
||
continue
|
||
_originals['shutil.' + name] = fn
|
||
|
||
def makes(fn):
|
||
def wrapper(path, *a, **kw):
|
||
return fn(long_path(path), *a, **kw)
|
||
return wrapper
|
||
setattr(shutil, name, makes(fn))
|
||
|
||
for name in ('move',):
|
||
fn = getattr(shutil, name, None)
|
||
if fn is None:
|
||
continue
|
||
_originals['shutil.' + name] = fn
|
||
|
||
def makes2(fn):
|
||
def wrapper(src, dst, *a, **kw):
|
||
return fn(long_path(src), long_path(dst), *a, **kw)
|
||
return wrapper
|
||
setattr(shutil, name, makes2(fn))
|
||
|
||
|
||
_install()
|
||
|
||
|
||
def probe(base):
|
||
"""自检:在 base 下建一条超长路径并写入/读回,返回 (是否成功, 说明)。
|
||
|
||
给界面或命令行排查用;平时不调用。
|
||
"""
|
||
deep = os.path.join(base, '_longpath_probe')
|
||
while len(deep) < 300:
|
||
deep = os.path.join(deep, 'LongSegmentName_0123456789')
|
||
target = os.path.join(deep, 'probe.txt')
|
||
try:
|
||
os.makedirs(deep, exist_ok=True)
|
||
with open(target, 'w', encoding='utf-8') as f:
|
||
f.write('ok')
|
||
with open(target, encoding='utf-8') as f:
|
||
got = f.read()
|
||
return got == 'ok', '长度 %d,写入并读回成功' % len(target)
|
||
except Exception as e: # pragma: no cover
|
||
return False, '%s: %s' % (type(e).__name__, e)
|
||
|
||
|
||
if __name__ == '__main__': # pragma: no cover
|
||
import sys
|
||
base = sys.argv[1] if len(sys.argv) > 1 else os.getcwd()
|
||
ok, msg = probe(base)
|
||
print(('[OK] ' if ok else '[FAIL] ') + msg)
|