excel-replace

This skill follows [[excel-safe-workflow]] four-step method. Must complete Requirement Parsing→Scout→Plan before execution, and Verify after. Must confirm before overwriting. 本技能遵循 [[excel-safe-workflow]] 四步法。执行前必须完成 需求解析→勘察→规划，执行后必须验证。替换覆盖前必须确认。

Excel Safe Replace (Column/Row/Cell) / Excel 安全替换（列/行/单元格）

第零步：需求解析

自动识别替换范围 / Auto-detect Replace Scope

用户说	判定
"这列全改成""E列替换为""整列"	→ 整列模式
"这行全改成""第5行替换为""整行"	→ 整行模式
"把所有空值改成""xxxx的替换为""条件替换"	→ 条件单元格模式
"B5改成""这个单元格"	→ 单单元格模式

解析要素

要素	说明	默认值
范围	整列/整行/条件/单格	从用户话中判定
目标	列号/列名/行号/单元格坐标	必须明确
新内容	固定值 / =开头的公式 / 自定义转换	必须明确
条件	（仅条件模式）"等于xx的""包含xx的""为空的"	必须明确

解析示例

用户说	提取
"把E列全部替换成'已确认'"	整列, E, 值='已确认'
"第3行整行清空"	整行, 3, 值=None
"状态列里所有'待审'改成'已审'"	条件, 状态列, 匹配='待审'→'已审'
"把空单元格全填上0"	条件(全局), 匹配=None→0
"B5改成'总计'"	单格, B5, 值='总计'
"金额列换成公式 =C2*D2"	整列, 金额列, 公式='=C2*D2'

第一步：勘察

import os, sys
sys.stdout.reconfigure(encoding='utf-8')
from openpyxl import load_workbook
from datetime import datetime

FILE = '目标文件.xlsx'
size_mb = os.path.getsize(FILE) / 1024 / 1024
print(f'文件大小: {size_mb:.1f} MB')

wb = load_workbook(FILE)
ws = wb.active
print(f'工作表: {ws.title}, 行: {ws.max_row}, 列: {ws.max_column}')

# 定位目标
target_col = None  # 整列模式
target_row = None  # 整行模式
target_cell = None # 单格模式

# 整列模式：定位列号
if SCOPE == 'column':
    if isinstance(target_spec, str):
        for col_idx in range(1, ws.max_column + 1):
            if ws.cell(row=1, column=col_idx).value == target_spec:
                target_col = col_idx
                break
    else:
        target_col = int(target_spec)

    print(f'\n目标列: 列{target_col} "{ws.cell(row=1, column=target_col).value}"')
    # 抽样展示
    for row in range(2, min(10, ws.max_row + 1)):
        v = ws.cell(row=row, column=target_col).value
        print(f'  行{row}: {repr(v)[:50]}')

# 条件模式：统计匹配数
if SCOPE == 'condition':
    match_count = 0
    for row in range(2, ws.max_row + 1):
        for col in range(1, ws.max_column + 1):
            v = ws.cell(row=row, column=col).value
            if CONDITION(v):  # 用户定义的条件
                match_count += 1
    print(f'\n条件匹配: {match_count} 个单元格（共 {ws.max_row * ws.max_column} 个）')

# 双重扫描
print('\n=== 双重扫描 ===')
wb2 = load_workbook(FILE, data_only=True)
ws2 = wb2.active
# ... 对比 target 区域
wb2.close()