Notion 批量查找与替换实战指南:从页内 Ctrl+F 局限、多选批量改属性到 Notion API 跨库正则清洗与 Formula 2.0 脏数据门禁

2026 年 11 月 19 日

一、Notion 查找与替换能力边界全景对照(为什么找不到“全局替换”?) #

当企业或个人知识库积累到数百页、数千条数据库记录后,经常会遇到品牌更名、旧域名下线(如 old-cdn.example.com 迁移至新域名)、产品 SKU 编码调整或统一纠正错别字的需求。此时很多从 Word、Excel 或 VS Code 迁移过来的用户会发现:Notion 并没有像本地编辑器那样的“跨工作区全局查找并替换(Global Find & Replace)”按钮。

因为 Notion 以块(Block)为单位存储富文本 JSON 结构,且页面分散在权限各异的团队空间中,直接执行无差别的全局替换极易误伤公式、引用链接和权限隔离页面。在实际运维中,应根据影响范围在以下四种方案中选型(快捷键基础参阅 Notion 终极高效快捷键手册 与 全局快捷键速查表):

查找与替换方案 作用范围 是否支持正则表达式 富文本与样式保留度 典型适用场景
原生页内查找替换(Cmd/Ctrl + F) 仅限当前打开的单个页面正文 不支持(仅纯文本匹配) 完整保留(仅替换文字) 单篇长文档错别字修正、局部术语微调
数据库视图多选批改(Cmd/Ctrl + A) 当前数据库视图选中的多行属性 不支持 仅改结构化属性,不改正文 批量更改任务负责人、Select 标签、状态流转
Formula 2.0 中继列 + 复制粘贴回填 当前数据库整列文本或 Title 属性 支持(replaceAll() / match()) 纯文本覆盖(适合字段洗数) 批量去掉标题前缀、统一手机号/SKU 格式、清洗 URL 参数
Notion API 跨库递归清洗脚本 整个工作区授权页面、数据库与嵌套块 完整支持 JS / Python 正则 支持按 rich_text 片段保留粗体/颜色/链接 品牌更名、全站外链域名迁移、万级文档合规词批量替换

二、无代码高效批量编辑实战:页内替换、多选批改与公式回填技巧 #

在无需编写任何代码的前提下,90% 的日常批量修改需求可以通过以下三个原生技巧高效解决:

1. 单页内精准查找与替换(含隐藏折叠块避坑) #

  1. 在目标页面按下 Cmd + F(macOS)或 Ctrl + F(Windows),打开右上角查找浮动栏,点击右侧 Replace 展开替换输入框。
  2. 输入旧词与新词,点击 Replace 逐个确认,或点击 Replace all 一键替换当前页面正文中的所有匹配项。
  3. 关键避坑点:页面内的 Toggle(折叠块)、Callout(高亮块) 中的文字支持被匹配,但内嵌数据库的 属性列(Properties) 以及 Synced Block(同步块)中的跨页引用 需注意权限——若当前用户对原同步块仅只读权限,替换操作将被跳过。

2. 数据库表格视图批量修改结构化属性 #

在整理项目台账或 CRM 客户库时(视图筛选用法见 视图、过滤和排序指南),切勿逐行下拉修改标签:

  1. 将数据库切换至 Table(表格) 视图,先用 Filter 精准筛选出需要批量修正的条目(例如筛选 状态 = 待审核 且 创建日期 < 2026-01-01)。
  2. 将鼠标移至第一行最左侧勾选框,按住 Shift 点击最后一行勾选框(或直接按 Cmd/Ctrl + A 全选当前筛选结果,单次建议不超过 100 行)。
  3. 顶部会浮现批量操作工具栏,直接点击目标属性图标(如 负责人、状态、标签 或 日期),即可在 1 秒内把上百条记录统一归档或重新指派;若需批量移动至其他数据库,直接点击工具栏 Move to 即可。

3. Formula 2.0 临时中继列:零代码实现“整列正则批量替换” #

Notion 数据库的 Title(标题)与 Text 属性不支持在选中多行后直接做查找替换,但我们可以巧用 Formula 2.0 中继列 30 秒搞定全列正则清洗(公式函数详见 Formula 2.0 速查手册):

  1. 在数据库中临时新建一个 Formula 属性,命名为 TMP_清洗结果。
  2. 写入正则清洗公式,例如去掉标题开头的旧编号前缀并把旧域替换为新域:
    prop("名称").replaceAll("^\\[旧版\\]\\s*", "").replaceAll("old\\.example\\.com", "cdn.example.com")
    
  3. 确认公式列预览全部正确后,在表格视图中拖动鼠标选中 TMP_清洗结果 整列单元格,按 Cmd/Ctrl + C 复制。
  4. 选中目标 名称(或 Text)列的对应起点单元格,按 Cmd/Ctrl + V 直接粘贴覆盖,最后删除临时公式列即可。

三、工程化跨页全局替换:Node.js Notion API 递归块级清洗脚本 #

当企业经历官网域名更换、旧 SaaS 链接迁移或需要批量更新数百个子页面正文中的敏感词与链接时,必须依靠 Notion API 实现自动化清洗(API 架构基础参阅 Notion API 外部系统集成指南 与 多源数据库迁移实战)。

执行脚本时有一条铁律:严禁把多个 rich_text 片段直接拍扁成一个纯字符串再写回,否则会丢失原有的加粗、高亮颜色与行内超链接。 正确的工程做法是遍历每个块的 rich_text 数组,逐段替换 text.content 与 text.link.url,并在默认开启 DRY_RUN=true 预览确认无误后再真正提交写入:

// batch-replace-notion.mjs (Node.js 20+, @notionhq/client)
import { Client } from '@notionhq/client';

const notion = new Client({ auth: process.env.NOTION_TOKEN });
const DRY_RUN = process.env.DRY_RUN !== 'false'; // 默认仅预览,设 DRY_RUN=false 才写入
const REPLACE_RULES = [
  { pattern: /https?:\/\/old-docs\.example\.com/g, replacement: 'https://docs.example.com' },
  { pattern: /【内部试行版】/g, replacement: '【V2.0 正式版】' }
];

const SUPPORTED_BLOCK_TYPES = [
  'paragraph', 'heading_1', 'heading_2', 'heading_3',
  'bulleted_list_item', 'numbered_list_item', 'to_do', 'toggle', 'callout', 'quote'
];

const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

function applyRulesToRichText(richTextArr = []) {
  let changed = false;
  const nextRichText = richTextArr.map((segment) => {
    if (segment.type !== 'text' || !segment.text) return segment;
    let content = segment.text.content;
    let linkUrl = segment.text.link?.url || null;

    for (const rule of REPLACE_RULES) {
      const nextContent = content.replace(rule.pattern, rule.replacement);
      if (nextContent !== content) {
        content = nextContent;
        changed = true;
      }
      if (linkUrl) {
        const nextUrl = linkUrl.replace(rule.pattern, rule.replacement);
        if (nextUrl !== linkUrl) {
          linkUrl = nextUrl;
          changed = true;
        }
      }
    }

    return {
      ...segment,
      text: { content, link: linkUrl ? { url: linkUrl } : null }
    };
  });

  return { changed, nextRichText };
}

async function processBlockTree(blockId) {
  let cursor = undefined;
  do {
    await sleep(360); // 严格控制在 ~2.8 req/s,防止触发 Notion 429 限流
    const res = await notion.blocks.children.list({ block_id: blockId, start_cursor: cursor, page_size: 50 });

    for (const block of res.results) {
      if (SUPPORTED_BLOCK_TYPES.includes(block.type)) {
        const payload = block[block.type];
        const { changed, nextRichText } = applyRulesToRichText(payload.rich_text);
        if (changed) {
          console.log(`[${DRY_RUN ? 'DRY-RUN' : 'UPDATE'}] Block ${block.id} (${block.type})`);
          if (!DRY_RUN) {
            await sleep(360);
            await notion.blocks.update({
              block_id: block.id,
              [block.type]: { rich_text: nextRichText }
            });
          }
        }
      }
      if (block.has_children && block.type !== 'child_page' && block.type !== 'child_database') {
        await processBlockTree(block.id);
      }
    }
    cursor = res.next_cursor;
  } while (cursor);
}

// 传入待清洗的父页面 ID 运行
await processBlockTree(process.env.TARGET_PAGE_ID);

四、Formula 2.0 脏数据检测与清洗门禁闭环 #

批量替换不仅是一次性运维动作,在高频录入的 CRM 线索库、知识库主表和商品 SKU 台账中,更需要用 Formula 2.0 建立长效的脏数据拦截防线(正则与字符串清洗技巧参阅 Formula 2.0 正则表达式清洗进阶 与 数据库查重清洗闭环)。

数据库字段名称 属性类型 规范校验目标与说明
标题名称 Title 禁止包含首尾空格、历史废弃前缀(如 [待迁移])
关联文档URL URL 禁止残留未迁移的 old-docs.example.com 或 http:// 非加密链接
标准编码 Text 必须严格符合 ^[A-Z]{2,4}-\d{4}$(如 PRD-0128)
清洗质检门禁 Formula 2.0 实时扫描文本脏字符、旧域名残留与编码违规,输出红色拦截提示

在 清洗质检门禁 属性中配置如下 Formula 2.0 规则即可实现自动巡检:

lets(
  titleRaw, prop("标题名称"),
  urlRaw, format(prop("关联文档URL")),
  codeRaw, prop("标准编码"),

  hasEdgeSpace, test(titleRaw, "^\\s+|\\s+$"),
  hasLegacyTag, contains(titleRaw, "待迁移") || contains(titleRaw, "【草稿】"),
  hasLegacyDomain, contains(urlRaw, "old-docs.example.com") || test(urlRaw, "^http://"),
  invalidCode, !empty(codeRaw) && !test(codeRaw, "^[A-Z]{2,4}-\\d{4}$"),

  ifs(
    hasLegacyDomain,
      style("🛑 含旧域名或明文HTTP · 请执行批量替换迁移", "red", "bold", "red_background"),
    invalidCode,
      style("🔴 标准编码违规 · 需符合 AA-0000 规范", "red", "bold"),
    hasEdgeSpace || hasLegacyTag,
      style("🟡 含首尾空格或旧标记 · 建议用中继公式清洗", "orange", "bold", "yellow_background"),
    style("🟢 数据格式洁净 · 通过质检门禁", "green", "bold", "green_background")
  )
)

五、批量操作误改自救与高频故障排查 #

  1. 批量粘贴覆盖错列怎么办?
    • 切勿连续刷新页面。若刚操作完,立即按 Cmd/Ctrl + Z 撤销;如果跨页面或已关闭标签页,点击页面右上角时钟图标打开 Page history(历史版本) 回滚至修改前快照(详参 历史版本恢复指南 与 常见故障排查手册)。
  2. API 批量替换时提示 400 validation_error 或丢失 @提及?
    • 原因是 rich_text 数组中混入了 type === "mention" 或 type === "equation" 片段。脚本中必须像上文示例那样仅处理 segment.type === 'text' 的片段,其余片段原样透传返回,才能确保页面里的 @成员、@日期 和行内数学公式完好无损。
  3. Database Automations 能否直接替代 API 做正文替换?
    • Notion 原生 Automations 目前擅长在属性变更时联动更新其他属性(如状态流转、自动指派),尚不支持对页面正文 Block 执行正则表达式替换。正文的跨页全局清洗仍需依赖 API 脚本或中继导出清洗方案(迁移清洗参阅 数据导入与无损迁入架构)。

❓ 常见问题与答疑 (FAQ)

高频疑难解析与避坑指南
A

完全不需要。绝大多数核心功能在免费 Free 计划中均可完整体验与实操练习,无需额外付费购买 Plus 或团队版。