Windows系统下os.replace()函数已知问题的解决方案求助

问题背景 #

写了个脚本从Firebase云存储下载文件到本地assets文件夹，同时替换.md笔记里的文件引用。最后用临时文件替换原文件时，触发PermissionError: [WinError 32] 进程无法访问文件，因为另一个进程正在使用它。已经确认是Windows系统上os.replace()的已知问题，不想用延迟（要处理数百个引用，效率太低）。

核心问题分析 #

原代码存在两个关键问题：

• 处理每一个Firebase链接后就立即替换原文件，此时原文件的句柄fhand还处于打开状态，导致系统锁定文件无法替换。
• 多次重复打开/替换同一文件，不仅效率低，还增加了文件占用冲突的概率。

解决方案 #

1. 批量处理替换操作：先收集当前笔记文件中所有需要替换的链接映射，一次性完成所有文本替换，避免多次操作文件。
2. 确保文件句柄完全关闭：在对原文件进行替换操作前，必须关闭所有打开的原文件句柄。
3. 替换os.replace为shutil.move：shutil.move在Windows下对文件占用的处理更稳健，同时兼容跨平台使用。

修改后的完整代码 #

import re
import os
import requests
import calendar
import time
import shutil

vaultDir = '/Users/kacar/Firebase Temp/Firebase-Test'

i = 0

# 遍历指定目录下的所有文件
for subdir, dirs, files in os.walk(vaultDir):
    for file in files:
        fileFullPath = os.path.join(subdir, file)
        # 只处理md文件（可选，根据需求调整）
        if not file.endswith('.md'):
            continue
            
        replace_mappings = []
        fhand = None
        try:
            fhand = open(fileFullPath, errors='ignore')
            for line in fhand:
                if 'firebasestorage' in line:
                    try:
                        # 匹配PDF格式和普通链接格式
                        if '{{pdf:' in line:
                            link = re.search(r'https://firebasestorage(.*)\?alt(.*)\}', line)
                        else:
                            link = re.search(r'https://firebasestorage(.*)\?alt(.*)\)', line)
                        
                        firebaseShort = 'https://firebasestorage' + link.group(1)
                        firebaseUrl = link.group(0)[:-1]
                        
                        # 下载文件到本地assets文件夹
                        r = requests.get(firebaseUrl)
                        timestamp = calendar.timegm(time.gmtime())
                        
                        # 获取文件扩展名
                        reg = re.search(r'(.*)\.(.+)', firebaseShort[-5:])
                        ext = '.' + reg.group(2)
                        
                        # 创建assets文件夹（如果不存在）
                        assets_dir = os.path.join(vaultDir, 'assets')
                        if not os.path.exists(assets_dir):
                            os.makedirs(assets_dir)
                        
                        # 生成本地文件路径
                        newFilePath = f'assets/{timestamp}_{i}{ext}'
                        local_file_path = os.path.join(vaultDir, newFilePath)
                        
                        with open(local_file_path, 'wb') as output_file:
                            output_file.write(r.content)
                        
                        # 记录需要替换的映射关系
                        replace_mappings.append((firebaseUrl, newFilePath))
                        i += 1
                        
                    except AttributeError:
                        continue
        finally:
            # 确保原文件句柄被关闭
            if fhand:
                fhand.close()
        
        # 如果有需要替换的内容，执行批量替换和文件替换
        if replace_mappings:
            fullTempFilePath = os.path.join(vaultDir, f'temp_{file}')
            
            # 读取原文件内容
            with open(fileFullPath, errors='ignore') as f:
                data = f.read()
            
            # 批量替换所有链接
            for old_url, new_path in replace_mappings:
                data = data.replace(old_url, new_path)
            
            # 写入临时文件
            with open(fullTempFilePath, 'wt') as temp_file:
                temp_file.write(data)
            
            # 使用shutil.move替换原文件，避免os.replace的Windows问题
            try:
                shutil.move(fullTempFilePath, fileFullPath)
            except Exception as e:
                print(f"替换文件 {fileFullPath} 时出错: {e}")
                # 出错时清理临时文件
                if os.path.exists(fullTempFilePath):
                    os.remove(fullTempFilePath)

额外优化点 #

• 增加了只处理.md文件的判断（可根据需求移除），避免处理无关文件。
• 使用finally块确保原文件句柄一定会被关闭，防止资源泄漏。
• 添加了错误处理和临时文件清理逻辑，避免出现残留垃圾文件。
• 使用os.path.join替代字符串拼接路径，提升跨平台兼容性。

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