# 零报错却零产出：舞台工艺图纸 AI 批处理导出链路的三站排查手册

## 开场：一次"全部成功"的批处理

某滨海文化中心的一次舞台工艺图纸送审，六十多张 DWG 要在半小时内转成 DXF、抽出图号、和送审目录做比对，最后给出缺项清单。管线搭好了：Python 负责编排，AutoCAD Core Console（`accoreconsole.exe`）负责转换，`ezdxf` 负责读回来解析。第一次跑，控制台刷了满屏 `[ OK ]`，退出码 0，日志里没有一个 ERROR。

然后打开输出目录——空的。

这就是本文要讲的那类故障：**零报错，零产出**。它不崩溃、不抛异常、不给你任何可以贴进搜索框的错误信息。更麻烦的是，如果你没有把校验做进管线，它会一路流到下游：解析阶段读不到文件就退回上一轮残留，比对阶段照样输出一份字段齐全的清单，直到交付验收那天才有人发现，这份清单里有一半结论是假的。

处理这类故障，靠"再跑一次看看"是没用的，得有一条固定的排查链。下面把它拆成三站，每站都有明确的判据和明确的分流动作。

## 一、先把排查链立起来

整条链只有四步，顺序不能颠倒：

- **探针**：开跑之前，先确认目标目录真的可写。不可写就不要启动批处理。
- **快照**：每一张图导出前后，各对输出目录拍一次快照，比较新增文件的字节数与 mtime。
- **对账**：整批跑完，用"成功数 == 输入数"做总数核对，不等就中断。
- **复读**：把产物用解析器重新打开一遍，能打开且实体数大于 0，才算真的成功。

前三步都在回答同一个问题——"磁盘上到底发生了什么"。第四步回答"这个产物是不是可用"。注意整条链里没有任何一步依赖返回值：返回值是接口对自己行为的陈述，磁盘是事实，两者之间隔着一层沙箱，而这层沙箱有权什么都不告诉你。

## 二、第一站：写操作被静默拦截，判定它而不是猜它

### 现象与危害

在脚本引擎里调用写文件接口，`open(path, 'w')` 也好、封装好的 `write_file()` 也好，返回成功、无异常、日志打印"写入完成"。打开目录：零个文件。

为什么这比报错危险得多？三个理由：

- **它不中断流水线**。报错你会当场处理，静默失败会继续往下流，污染的是最终交付物。
- **它推迟了暴露时点**。等验收阶段发现问题时，命令行回显没了、临时脚本被清了，复现上下文全部丢失。
- **规模越大越隐蔽**。六十张图里三张失败，扫一眼文件列表完全看不出来——文件名都在，其中三个是上周的旧产物。

### 判据：新增数、字节数、时间戳，三者缺一不可

```python
from pathlib import Path
from datetime import datetime

def snapshot(d: Path) -> dict:
    d = Path(d)
    if not d.exists():
        return {"__dir__": "MISSING"}
    return {p.name: (p.stat().st_size, int(p.stat().st_mtime))
            for p in d.iterdir() if p.is_file()}

def judge(before: dict, after: dict, t0: float) -> str:
    """返回 PASS / COVER / SILENT_FAIL / MISSING"""
    if after.get("__dir__") == "MISSING":
        return "MISSING"
    added = {k: v for k, v in after.items() if k not in before}
    changed = {k for k in after if k in before and before[k] != after[k]}
    if not added and not changed:
        return "SILENT_FAIL"          # 磁盘上什么都没发生
    if not added and changed:
        return "COVER"                # 在覆盖旧文件，不是新增
    stale = [k for k, (sz, mt) in added.items() if sz == 0 or mt < t0]
    return "PASS" if not stale else "STALE"
```

四个返回值的含义和分流动作：

- **PASS**：新增文件非空，且 mtime 不早于本轮起始时间。放行。
- **COVER**：只有覆盖没有新增——几乎一定是输出名写死了（见第三站）。
- **SILENT_FAIL**：磁盘毫无变化——沙箱拦截实锤，进入换路径重试流程。
- **STALE**：有新增但字节为 0，或 mtime 早于本轮——你拿到的是空文件或上一轮残留。

`mtime` 这一条是识别"旧产物冒充新产物"的唯一可靠手段，文件名和字节数都能骗人，时间戳骗不了。

### 排查顺序：不要凭直觉跳步

```python
def probe_writable(d: Path) -> bool:
    d = Path(d)
    d.mkdir(parents=True, exist_ok=True)
    p = d / "_probe.tmp"
    try:
        p.write_text("probe", encoding="utf-8")
        ok = p.exists() and p.stat().st_size > 0
        p.unlink(missing_ok=True)
        return ok
    except Exception:
        return False
```

三步固定顺序：

1. 先跑 `probe_writable(out_dir)`。返回 `False` 就换目录或提权，别往下走。
2. 再确认写的是绝对路径。沙箱常见的处理是把相对路径落到进程当前工作目录——你以为写到了 D 盘，实际落在某个临时目录。用 `Path(out).resolve()` 打一次真实落点。
3. 最后才怀疑接口本身被拦。换目录、换扩展名（先写 `.txt`）各试一次，二分定位是路径问题还是文件类型问题。

顺便说一句环境：本文实测环境为 Windows 11 + AutoCAD 2024（`accoreconsole.exe` 默认在 `C:\Program Files\Autodesk\AutoCAD 2024\`）+ Python 3.11 + `ezdxf>=1.1`。2020 及以后版本都自带 Core Console，路径里的年号按实际替换。

## 三、第二站：导出命令在脚本里的正确写法

### `_.` 前缀在干什么

可移植的 AutoCAD 脚本，命令名前面那两个字符各有职责：

- **`_`**：告诉 AutoCAD 后面的命令名按英文原名解析。中文版安装里命令是本地化的，换语言环境就失效；加下划线后无论界面语言如何都走英文原名。
- **`.`**：强制使用内建定义，绕过被 AutoLISP 重定义过的同名命令。这是防御性的——你不知道目标机器上有没有人改写过什么。

叠加成 `_.`，成本为零，收益是脚本在任何语言、任何被改写过的环境里行为一致。

### 三行式

`.scr` 是纯文本回显流，一行对应一次回车，没有解释器、没有变量、没有字符串拼接能力。导出命令的标准写法：

```text
_.DXFOUT
<选项行：精度 / 格式；留空即回车取默认>
<输出文件完整路径>
```

第一行命令，第二行应答选项提示（精度位数、是否二进制等，留空取默认），第三行应答文件名提示，末尾补一个空行等价于最后再敲一次回车。

不同版本的提示顺序不完全一致，有的是"文件名 → 精度"，有的是"格式 → 文件名"。判据很朴素：拿一张图单跑一次，把控制台回显抓下来看提示文字顺序，然后对调第二三行。回显是唯一现场证据，一定要收。

### 调度参数

```python
import subprocess
from pathlib import Path

ACC = r"C:\Program Files\Autodesk\AutoCAD 2024\accoreconsole.exe"

def call_acc(dwg: Path, scr: Path) -> subprocess.CompletedProcess:
    cmd = [str(ACC), "/i", str(dwg), "/s", str(scr), "/l", "en-US"]
    return subprocess.run(cmd, capture_output=True, text=True, timeout=300)
```

`/i` 指定输入图纸，`/s` 指定脚本，`/l en-US` 锁定界面语言，和 `_.` 前缀构成双保险。两个容易忽略的点：`timeout` 必须填——Core Console 偶发卡在未预期的提示上，没有超时整批挂死；`capture_output=True` 必须开——回显是后续排障唯一的现场证据。

## 四、第三站：文件名硬编码，于是第二张覆盖第一张

这一站是第二站的直接推论。既然 `.scr` 里没有变量、没有字符串拼接，输出名就只能是写死的完整路径。让六十张图都导出到同一个名字，最后目录里只剩一个文件，内容是第六十张——而且同样不报错，`judge()` 会干净利落地返回 `COVER`。

两条路线：

- **一图一脚本**：循环里为每张图生成一个脚本，把输出名烧进去。脚本文件多，统一放临时目录、收尾清理。
- **固定名 + 导出即搬运**：永远导出到 `_stage.dxf`，跑完一张立刻 `shutil.move` 并按规则改名，确认搬运成功再跑下一张。脚本只生成一次，但搬运失败就会覆盖。

推荐前者为主、后者的改名逻辑兜底：

```python
import re
import shutil
import unicodedata

def safe_name(s: str) -> str:
    s = unicodedata.normalize("NFKC", s)
    s = re.sub(r'[\\/:*?"<>|]', "_", s)
    return s.strip().rstrip(".") or "unnamed"

def ship(src: Path, dst_dir: Path, dst_name: str) -> Path:
    """搬运 + 防覆盖；返回最终落点"""
    dst_dir.mkdir(parents=True, exist_ok=True)
    dst = dst_dir / safe_name(dst_name)
    if dst.exists():
        stem, suf, i = dst.stem, dst.suffix, 1
        while (dst_dir / f"{stem}_{i}{suf}").exists():
            i += 1
        dst = dst_dir / f"{stem}_{i}{suf}"
    shutil.move(str(src), str(dst))
    return dst
```

防覆盖这一句不是洁癖。同名覆盖在单张调试时看不出问题，一旦并发或重跑就变成"结果对不上但说不清为什么"，排查成本远高于写这几行。

## 五、最后一公里的两道暗坑

主线跑通之后，最容易翻车的反而是收尾这两处。

### 5.1 自定义符号撞上命令别名

`acad.pgp` 里定义了几百个两三个字母的命令别名（`L`、`C`、`TR`、`E`、`REC`、`PE`……）外加一堆命令原名。自定义 AutoLISP 函数或变量跟它们同名，解释器会优先当命令消费，表现为**行为诡异但不报错**——典型症状是脚本跑到某一行突然执行一个完全不相干的编辑命令，图被改了，你找不到是哪一步改的。

规避办法：所有自定义符号统一加私有前缀（如 `ztb:`）；`c:` 前缀只留给真正要暴露给命令行的入口；交付前做一次撞名扫描。

```python
import re
from pathlib import Path

IDENT = re.compile(r"\(defun\s+(?:c:)?([A-Za-z0-9_\-:]+)")

def clash_report(lisp_files, pgp_path) -> list:
    idents = set()
    for f in lisp_files:
        txt = Path(f).read_text(encoding="utf-8", errors="ignore")
        idents |= set(IDENT.findall(txt))
    aliases = set()
    for line in Path(pgp_path).read_text(encoding="utf-8", errors="ignore").splitlines():
        if line and not line.startswith(";"):
            parts = line.split(",")
            if parts:
                aliases.add(parts[0].strip().upper())
    return sorted(i for i in idents if i.upper() in aliases)
```

### 5.2 图号文字不只在模型空间

图号、图名这类文字在 DXF 里至少有四种藏身处：模型空间、图纸空间布局（标题栏常整块放这里）、块定义内部（通过 `INSERT` 引用，最容易被漏）、块参照上的属性值（`ATTRIB`，图号常被做成带属性的标题块，文字挂在 INSERT 实例上而不在块定义里）。

只查模型空间的 `TEXT/MTEXT`，抽到 0 条是常态不是异常。正确姿势是遍历「模型空间 + 全部布局 + 全部块定义」，并对 `INSERT` 做虚拟实体展开：

```python
import ezdxf

TEXT_TYPES = ("TEXT", "MTEXT", "ATTRIB")

def all_text(doc):
    for sp in [doc.modelspace(), *doc.layouts()]:
        for e in sp:
            if e.dxftype() in TEXT_TYPES:
                yield sp.name, e
            elif e.dxftype() == "INSERT":
                for v in e.virtual_entities():     # 展开块内实体，含嵌套
                    if v.dxftype() in TEXT_TYPES:
                        yield sp.name, v
                for a in e.attribs:                # 块参照属性值
                    yield sp.name, a
    for blk in doc.blocks:                         # 块定义本体
        if blk.name.startswith("*"):
            continue
        for e in blk:
            if e.dxftype() in TEXT_TYPES:
                yield blk.name, e

def plain(e) -> str:
    return e.text if e.dxftype() == "MTEXT" else e.dxf.get("text", "")
```

抽到 0 条时，程序能证明的只有一件事：这条路径没命中。它证明不了图上没画。前四站解决的是"文件在不在、对不对得上"，这一类问题 `reread()` 也测不出来——DXF 能正常打开、实体数不为零，但实体里没有文字这件事它是盲区。判定只能再往前推一步：把遍历范围当变量，逐类放开看命中数。

### 排查到第几步了：怎么确认自己真的遍历全了

舞台工艺深化图的出图习惯，决定了命中数会落在哪几类容器上。机械专业的台口与吊杆剖面在模型空间，灯光专业的光位图剖面也在模型空间，可灯光回路编号与系统图整张压在布局空间；音响专业的桥架路由走向在模型，出图页连图例带系统编号在布局；视频专业的机位图图号做成带属性的标题块，文字挂在块参照属性值上，模型与块定义本体里都查不到。

按这个分布逐类放开：模型空间命中平面标注，布局空间命中出图页与图签栏，块定义命中图框内的标题栏，`ATTRIB` 命中属性型图号。任何一类为 0 都要单独记一条，别让合计数把它盖过去——合计两百条而布局空间 0 条，往往是出图页整个没进来，不是这批图没标编号。

审图落点到此才轮得上：命中 0 条的那张图，判读上**不能写"缺图"**。0 条是技术根因，不是判读结论，程序没有资格对图纸内容下判断。落到意见上应是「待人工核对项」，标清图号、专业、载体类型随核对单退回；人工回原图确认确实没有，才进缺项清单。链路能做的只是把六十张图缩成三五张需要人看的范围，判定那一步永远留在人这边。

## 六、把排查链固化成脚本

把四步链写成单文件，加一个 `--dry-run` 用于不开 AutoCAD 先验证目录与路径逻辑：

```python
# -*- coding: utf-8 -*-
"""舞台工艺图纸批处理导出 DXF —— 排查链版
用法：
  python chain_export.py <输入DWG目录> <输出DXF目录> [--dry-run]
"""
import argparse
import shutil
import subprocess
import sys
import time
from pathlib import Path

ACC = r"C:\Program Files\Autodesk\AutoCAD 2024\accoreconsole.exe"


def stage(msg: str) -> None:
    print(f"[{time.strftime('%H:%M:%S')}] {msg}", flush=True)


def export_one(dwg: Path, tmp_out: Path, work: Path, dry=False) -> int:
    scr = work / f"_{dwg.stem}.scr"
    scr.write_text(f"_.DXFOUT\n\n{str(tmp_out)}\n", encoding="utf-8", newline="\n")
    if dry:
        stage(f"DRY  {dwg.name} -> {tmp_out.name}")
        return 0
    cmd = [str(ACC), "/i", str(dwg), "/s", str(scr), "/l", "en-US"]
    try:
        r = subprocess.run(cmd, capture_output=True, text=True, timeout=300)
    except subprocess.TimeoutExpired:
        stage(f"FAIL {dwg.name} 超时")
        return -1
    if not (tmp_out.exists() and tmp_out.stat().st_size > 0):
        (work / f"{dwg.stem}.log").write_text(
            (r.stdout or "") + (r.stderr or ""), encoding="utf-8")
        stage(f"FAIL {dwg.name} rc={r.returncode} 无产出")
        return r.returncode
    return 0


def main() -> int:
    ap = argparse.ArgumentParser()
    ap.add_argument("src")
    ap.add_argument("dst")
    ap.add_argument("--dry-run", action="store_true")
    a = ap.parse_args()

    src, dst = Path(a.src), Path(a.dst)
    work = dst / "_work"
    work.mkdir(parents=True, exist_ok=True)
    dst.mkdir(parents=True, exist_ok=True)

    t0 = time.time()
    # 第 1 站：探针
    if not probe_writable(dst):
        stage("FATAL 输出目录不可写"); return 2

    dwgs = sorted(p for p in src.glob("*.dwg") if not p.name.startswith("~$"))
    if not dwgs:
        stage("FATAL 输入目录没有 DWG"); return 2
    stage(f"待处理 {len(dwgs)} 张")

    ok = []
    for dwg in dwgs:
        before = snapshot(dst)
        tmp = work / "_stage.dxf"
        tmp.unlink(missing_ok=True)
        if export_one(dwg, tmp, work, a.dry_run) != 0:
            continue
        if a.dry_run:
            ok.append(dwg.name); continue
        # 第 2 站：快照判定
        verdict = judge(before, snapshot(dst), t0)
        if verdict in ("PASS", "STALE"):
            ship(tmp, dst, f"{dwg.stem}.dxf")
            ok.append(dwg.name)
            stage(f"OK   {dwg.name} ({verdict})")
        else:
            stage(f"FAIL {dwg.name} 判定={verdict}")

    # 第 3 站：总数对账
    stage(f"对账：输入 {len(dwgs)} / 成功 {len(ok)}")
    if len(ok) != len(dwgs):
        stage("WARN 数量不一致，禁止进入下游解析")
        return 1
    # 第 4 站：复读
    bad = reread(dst)
    stage(f"复读：异常 {len(bad)} 个 {bad}")
    return 0


def reread(d: Path) -> list:
    import ezdxf
    bad = []
    for f in sorted(Path(d).glob("*.dxf")):
        try:
            doc = ezdxf.readfile(f)
            n = len(list(doc.modelspace())) + sum(len(list(l)) for l in doc.layouts())
            if n == 0:
                bad.append(f.name)
        except Exception:
            bad.append(f.name)
    return bad


if __name__ == "__main__":
    sys.exit(main())
```

（`probe_writable`、`snapshot`、`judge`、`ship` 四个函数取自上文，拼在一起即可直接跑。）

## 七、交付前的自检清单

按顺序过一遍，任何一项不过就不许进下一阶段：

- 输出目录探针通过，且打印出的 `resolve()` 真实落点与你以为的一致。
- 每张图的判定结果都是 `PASS`；出现 `COVER` 说明输出名写死了，出现 `SILENT_FAIL` 说明被拦截。
- 所有产物的 `mtime` 不早于本轮起始时间。
- `成功数 == 输入 DWG 数`。
- `reread()` 返回空列表，即所有 DXF 都能被解析且非空。
- 自定义符号已过 `clash_report`，无撞名。
- 文字抽取为 0 的图，已列入人工核对清单，未被直接判为缺项。
- 路径不含空格；若必须含，脚本生成后打印内容人工确认一次。
- 若脚本要跑在完整 AutoCAD 而非 Core Console 里，先 `(setvar "FILEDIA" 0)`，否则保存对话框会让进程挂死。

## 结尾

这三站故障有一个刺眼的共同点：都不报错。沙箱拦截不报错，文件名覆盖不报错，抽到 0 条也不报错。所以排查的关键从来不是"命令怎么写"，而是"怎么让失败自己浮出来"——探针先行、快照判定、总数对账、产物复读。

把这四件事做成固定骨架之后，你会发现它和具体工具无关：换成别的 CAD 转换工具、换成别的批处理场景，链条照旧成立。对舞台工艺这类成批送审的图纸处理来说，这份严谨尤其值钱——产出的核对表是要被追责的，而"可追责"的前提，是每一步产出都经过磁盘层面的独立验证，而不是相信某个接口返回的那句"成功"。


某滨海文化中心的一次舞台工艺图纸送审，六十多张 DWG 要在半小时内转成 DXF、抽出图号、和送审目录做比对，最后给出缺项清单。管线搭好了：Python 负责编排，AutoCAD Core Console（accoreconsole.exe）负责转换，ezdxf 负责读回来解析。第一次跑，控制台刷了满屏 [ OK ]，退出码 0，日志里没有一个 ERROR。

零报错却零产出：舞台工艺图纸 AI 批处理导出链路的三站排查手册

命令全成功、日志零报错，输出目录却是空的。本文从这一现场出发，把舞台工艺图纸批处理导出的故障拆成四站排查链：写能力探针、目录快照判定、总数对账、产物复读，逐站给出判据与可复制脚本。

编程语言

零报错却零产出：舞台工艺图纸AI批处理导出链路的三站排查手册。聚焦DWG转DXF批处理中"全部成功"却无产出的隐蔽故障，提供探针、快照、对账、复读四步排查链，涵盖写操作静默拦截、脚本参数陷阱、文件名覆盖三大根因，附完整脚本与自检清单，确保交付物可追责。

代码解释

解释器

容器

路由

Python

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

零报错却零产出：舞台工艺图纸 AI 批处理导出链路的三站排查手册-腾讯云开发者社区-腾讯云

零报错却零产出：舞台工艺图纸 AI 批处理导出链路的三站排查手册

零报错却零产出：舞台工艺图纸 AI 批处理导出链路的三站排查手册

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐