Python访问UNC路径失败主因是网络重定向未解析，非权限问题；推荐用win32wnet映射盘符或pysmb库直连SMB，注意会话上下文、SMB版本及超时处理。
Python访问UNC路径报错“系统找不到指定的路径”
Windows上直接用 os.path.exists(r"\servershare ile.txt") 或 open(r"\servershare ile.txt") 失败，多数是因为Python默认不解析UNC路径中的网络重定向，尤其在非交互式环境（如服务、计划任务、PyInstaller打包后）下更明显。
- 不是权限问题，而是路径未被系统“挂载”为可识别的文件系统对象
- Python 3.6+ 对UNC支持有改进，但依然依赖底层Windows API是否返回有效句柄
- 推荐先用
os.path.normpath()标准化路径，再尝试访问；若仍失败，必须显式处理SMB连接 - 避免硬编码双反斜杠，统一用原始字符串：
r"\serversharepath"，否则"s"会被误解析为转义符
用pythonnet或win32wnet映射网络驱动器临时盘符
当需要稳定读写、或调用依赖盘符的第三方库（如某些Excel处理模块）时，把UNC路径映射成 Z: 这类盘符最直接。但要注意：映射是用户会话级的，脚本退出后不会自动断开，且不能跨用户生效。
- 用
win32wnet.WNetAddConnection2()显式连接，需传入resource（UNC路径）、username、password和可选connection_name（如"Z:"） - 连接成功后，
os.listdir("Z:\")就能正常工作，无需改业务逻辑 - 务必在退出前调用
win32wnet.WNetCancelConnection2("Z:", 0, 0)，否则残留映射可能阻塞后续运行 - 如果目标服务器启用了SMB签名或强制加密，而本地策略不匹配，
WNetAddConnection2会静默失败，此时应检查Windows事件查看器中SMB客户端日志
绕过映射，直接用requests + SMB协议库操作文件
纯Python方案里，pysmb 是目前最轻量、兼容性较好的选择，它不依赖Windows API，适合跨平台部署或容器环境，但只支持SMBv1/v2（不支持v3加密通道），且无法处理NTFS ACL等高级特性。
- 安装：
pip install pysmb，注意它不包含在标准库中 - 连接示例：
SMBConnection("user", "pass", "cli", "srv", use_ntlm_v2=True, is_direct_tcp=True)，其中is_direct_tcp=True表示走445端口（而非139），避免NetBIOS层干扰 - 列出目录：
conn.listPath("share_name", "/subdir/")，注意这里用正斜杠，且路径以/开头，不是UNC格式 - 下载文件：
with open("local.txt", "wb") as f: conn.retrieveFile("share_name", "/remote.txt", f)，大小超过几MB时建议加timeout参数防卡死
在Linux/macOS上访问Windows共享的现实约束
Python本身不提供跨平台SMB实现，Linux下必须依赖外部工具（如 cifs-utils）挂载，再用普通文件操作。这意味着你的脚本不再是纯Python，而是和系统配置强绑定。
立即学习“Python免费学习笔记（深入）”；
- 先用
mount -t cifs //server/share /mnt/share -o username=user,password=pass,uid=1000,gid=1000,vers=3.0挂载（vers参数必须匹配服务端SMB版本） - Python中操作
/mnt/share/file.txt即可，但要确保挂载点存在、权限可写、且脚本有执行mount的能力（通常需sudo） - 挂载后若服务端重启或网络中断，
ls /mnt/share可能卡住，Python进程也会hang住——必须设置超时：os.scandir("/mnt/share").__next__()加signal.alarm()或用子进程调用带timeout的find - macOS对SMB支持较弱，特别是v3加密，默认挂载常失败，建议在
/etc/nsmb.conf中添加signing_required=no（仅测试环境）
UNC路径看着像本地路径，但它背后是网络I/O、身份验证、协议协商三重关卡。最容易被忽略的是：同一段代码，在开发者桌面能跑通，放到Docker容器或Windows服务里就失败——差别往往就在会话上下文和凭据代理方式上。别假设“路径对了就能读”，先确认你真正连上了那个SMB会话。
