景卡頓優(yōu)化：用Python精準(zhǔn)清除隱藏垃圾節(jié)點(diǎn))
最近接手一個(gè)從上游拿來(lái)的動(dòng)畫(huà)場(chǎng)景打開(kāi) Maya 之后等了快兩分鐘拖一下時(shí)間軸都感覺(jué)被“粘住”把 Outliner 里能看到的物體七七八八刪得差不多還是不見(jiàn)好轉(zhuǎn)。后來(lái)在 Script Editor 里查了一遍才發(fā)現(xiàn)場(chǎng)景里躺著幾十個(gè) unknown 節(jié)點(diǎn)、一堆沒(méi)有任何幾何體引用的 shadingEngine還有些連 Outliner 都不會(huì)顯示的孤立 expression。這類問(wèn)題在綁定、燈光和渲染環(huán)節(jié)特別常見(jiàn)。很多人以為“清理文件”就是把 Outliner 里的無(wú)用物體刪掉或者用一次“Optimize Scene Size”就了事。真正的垃圾節(jié)點(diǎn)往往藏在你看不見(jiàn)的 DG 層里肉眼和手工都很難發(fā)現(xiàn)。本文會(huì)從 Maya 節(jié)點(diǎn)的底層機(jī)制講起分析垃圾節(jié)點(diǎn)為什么會(huì)產(chǎn)生再給出一套“先掃描、再備份、后清理、可驗(yàn)證”的 Python 完整方案。文章里的代碼允許你先 dry-run只打印候選節(jié)點(diǎn)不執(zhí)行任何刪除。確認(rèn)無(wú)誤后再切換為真正清理降低誤刪材質(zhì)和綁定結(jié)構(gòu)的風(fēng)險(xiǎn)。讀完你至少能自己做一個(gè)小而穩(wěn)的 Maya 文件清理工具。1. Maya 里的“垃圾節(jié)點(diǎn)”到底是什么先解釋一個(gè)很容易被忽略的事實(shí)Maya 并不是用“物體”來(lái)管理場(chǎng)景的Maya 的全部?jī)?nèi)容都是節(jié)點(diǎn)Node靠節(jié)點(diǎn)之間的連接關(guān)系形成場(chǎng)景網(wǎng)絡(luò)。也就是說(shuō)你在 Outliner 里看到的模型、燈光、攝像機(jī)只是節(jié)點(diǎn)網(wǎng)絡(luò)里的很小一部分表現(xiàn)。大量負(fù)責(zé)數(shù)據(jù)計(jì)算、材質(zhì)分配、約束控制的節(jié)點(diǎn)并不會(huì)直接顯示在 Outliner 中。Maya 節(jié)點(diǎn)大致分成兩類DAG 節(jié)點(diǎn)存在于場(chǎng)景層級(jí)里的節(jié)點(diǎn)比如 Transform、Shape、Joint。DG 節(jié)點(diǎn)存在于依賴圖里的節(jié)點(diǎn)比如 ShadingEngine、Expression、Utility 節(jié)點(diǎn)。DG 節(jié)點(diǎn)不直接出現(xiàn)在 Outliner 的默認(rèn)視圖里但它們可能占據(jù)大量文件體積和內(nèi)存。所謂“垃圾節(jié)點(diǎn)”通常不是指某個(gè)節(jié)點(diǎn)類型本身低劣而是指這些節(jié)點(diǎn)在場(chǎng)景中已經(jīng)沒(méi)有任何實(shí)際用途卻仍然被保存下來(lái)。常見(jiàn)類型可以整理成一張表垃圾節(jié)點(diǎn)類型通常位置主要來(lái)源誤刪風(fēng)險(xiǎn)unknown / unknownDag 節(jié)點(diǎn)Outliner 不顯示插件卸載、版本轉(zhuǎn)換中低若插件后續(xù)要裝回則需謹(jǐn)慎孤立 shadingEngineHypershade 中可見(jiàn)刪除物體后材質(zhì)網(wǎng)絡(luò)殘留中可能牽連使用中的材質(zhì)孤立 expression / utility 節(jié)點(diǎn)不直觀刪除控制器后保留表達(dá)式中可能被表達(dá)式或驅(qū)動(dòng)關(guān)鍵幀引用空 transform / groupOutliner 可見(jiàn)手動(dòng)重建、復(fù)制殘留中低但空組可能是控制器父組動(dòng)畫(huà)曲線或 animLayer 殘留Graph Editor 可見(jiàn)斷開(kāi)動(dòng)畫(huà)后遺留中避免誤刪引用動(dòng)畫(huà)從實(shí)際項(xiàng)目角度看垃圾節(jié)點(diǎn)會(huì)造成幾個(gè)直接結(jié)果一是文件打開(kāi)和保存變慢二是時(shí)間軸播放和視口操作卡頓三是交接時(shí)下游不知道哪些節(jié)點(diǎn)可以刪四是在渲染農(nóng)場(chǎng)提交任務(wù)時(shí)會(huì)把無(wú)用節(jié)點(diǎn)一并帶過(guò)去增加傳輸和解析成本。所以這里有一個(gè)判斷清理垃圾節(jié)點(diǎn)不是追求“文件變小”這種表面效果而是讓場(chǎng)景網(wǎng)絡(luò)恢復(fù)健康保證后續(xù)制作和交付環(huán)節(jié)不被無(wú)意義的節(jié)點(diǎn)拖累。一個(gè)穩(wěn)定的清除流程應(yīng)該先搞清楚節(jié)點(diǎn)是屬于 DAG 還是 DG再判斷是否“被引用”最后才決定是否刪除。2. 垃圾節(jié)點(diǎn)為什么清理不干凈常見(jiàn)來(lái)源與誤區(qū)如果只是偶爾清理一次很多團(tuán)隊(duì)會(huì)發(fā)現(xiàn)一個(gè)問(wèn)題隔幾周場(chǎng)景又變大了又出現(xiàn)一堆陌生節(jié)點(diǎn)。這說(shuō)明垃圾節(jié)點(diǎn)的源頭沒(méi)有處理干凈。從材料看垃圾節(jié)點(diǎn)在模型綁定、動(dòng)畫(huà)和渲染流程里反復(fù)出現(xiàn)主要有幾個(gè)來(lái)源第一反復(fù)導(dǎo)入?yún)⒖嘉募蚝喜⑼獠繄?chǎng)景會(huì)導(dǎo)致節(jié)點(diǎn)帶有 namespace之后移除 namespace 時(shí)網(wǎng)絡(luò)連接并沒(méi)有完全清理留下大量孤立 DAG 和 DG 節(jié)點(diǎn)。比如 FBX 導(dǎo)入、Alembic 導(dǎo)入都很容易在材質(zhì)和變形器層面留下多余節(jié)點(diǎn)。第二引用文件卸載不徹底。Maya 的 Reference 機(jī)制會(huì)把被引用內(nèi)容當(dāng)作一個(gè)節(jié)點(diǎn)網(wǎng)絡(luò)加載進(jìn)來(lái)。如果只是執(zhí)行了 Unload Reference而沒(méi)有真正移除或 delete reference后續(xù)該 Reference 里的節(jié)點(diǎn)仍然可能殘留在場(chǎng)景文件中。第三插件卸載后節(jié)點(diǎn)類型丟失。如果場(chǎng)景里使用了第三方插件創(chuàng)建的節(jié)點(diǎn)而打開(kāi)場(chǎng)景的機(jī)器沒(méi)有安裝該插件Maya 會(huì)把這類節(jié)點(diǎn)標(biāo)記為 unknown。表面上看它還在但 Maya 不認(rèn)識(shí)它的具體類型也無(wú)法正常處理它的連接。很多人想清理 unknown 節(jié)點(diǎn)卻又擔(dān)心插件后續(xù)還要裝回來(lái)所以越積越多。第四手動(dòng)刪除物體時(shí)沒(méi)有清理材質(zhì)和渲染節(jié)點(diǎn)。例如刪除了一個(gè)角色模型但它的材質(zhì)網(wǎng)絡(luò)、shadingEngine、貼圖節(jié)點(diǎn)可能仍然留在 Hypershade 中。再有就是綁定過(guò)程中復(fù)制了很多 locator 和 group最后一版沒(méi)有用到但沒(méi)人去刪。很多新手會(huì)陷入一個(gè)誤區(qū)只要 Outliner 里看不見(jiàn)就認(rèn)為文件是干凈的。真正的垃圾很多是看不見(jiàn)的 DG 節(jié)點(diǎn)。另一個(gè)誤區(qū)是“清理就像刪除不用的文件直接選中刪除就行”。但 Maya 里節(jié)點(diǎn)之間存在大量隱藏連接一個(gè)看似獨(dú)立的節(jié)點(diǎn)可能在連接編輯器里被表達(dá)式、驅(qū)動(dòng)關(guān)鍵幀或引用文件引用。如果不過(guò)濾引用不檢查連接很容易刪掉后續(xù)還要使用的數(shù)據(jù)。這也是為什么本文的方案會(huì)刻意做成四個(gè)階段掃描、備份、dry-run、執(zhí)行清理。先讓腳本告訴你有哪些候選再由你判斷是否需要清理而不是讓腳本把所有可疑節(jié)點(diǎn)全部一把梭刪掉。3. 清理前先備份給場(chǎng)景吃“后悔藥”無(wú)論腳本寫得多安全刪除操作都具有不可逆性。在進(jìn)入清理之前必須先給當(dāng)前場(chǎng)景做一次備份。這里說(shuō)的備份不是“心智上的記住”而是實(shí)際生成一個(gè)帶時(shí)間戳的文件副本放在當(dāng)前場(chǎng)景旁邊。在 Maya 里執(zhí)行 Python 腳本前先手動(dòng)保存一次場(chǎng)景。下面的代碼會(huì)讀取當(dāng)前 Maya 場(chǎng)景路徑復(fù)制它到一個(gè)新文件文件名帶上before_clean標(biāo)記和時(shí)間戳。這樣如果清理后發(fā)現(xiàn)問(wèn)題可以直接打開(kāi)備份版本恢復(fù)。# 文件路徑examples/maya_scene_cleaner.py 清理前備份工具 在 Maya Script Editor 中執(zhí)行會(huì)復(fù)制當(dāng)前場(chǎng)景到同級(jí)目錄。 import os import shutil import datetime import maya.cmds as cmds def backup_current_scene(): current_scene cmds.file(queryTrue, sceneNameTrue) if not current_scene or not os.path.exists(current_scene): cmds.warning(當(dāng)前場(chǎng)景尚未保存請(qǐng)先保存后再執(zhí)行備份。) return None base, ext os.path.splitext(current_scene) stamp datetime.datetime.now().strftime(%Y%m%d_%H%M%S) backup_path {base}_before_clean_{stamp}{ext}.format( basebase, stampstamp, extext or .ma ) try: shutil.copy2(current_scene, backup_path) print(備份完成{path}.format(pathbackup_path)) except Exception as exc: cmds.error(備份失敗{}.format(exc)) return None return backup_path if __name__ __main__: backup_path backup_current_scene() if backup_path: cmds.confirmDialog( title備份完成, message場(chǎng)景備份成功。\n{}.format(backup_path), button[確定], defaultButton確定, )這段代碼里的關(guān)鍵點(diǎn)是使用cmds.file(queryTrue, sceneNameTrue)獲取當(dāng)前路徑而不是自己拼接路徑。對(duì)于.ma和.mb格式都適用。接著用os.path.splitext分離文件名和后綴生成xxx_before_clean_20250214_153000.ma這樣的備份副本。需要注意如果當(dāng)前場(chǎng)景還沒(méi)保存過(guò)sceneName返回為空代碼會(huì)中止并提示先保存。不要嘗試在未保存狀態(tài)下直接復(fù)制臨時(shí)文件因?yàn)?Maya 的臨時(shí)文件未必等于當(dāng)前場(chǎng)景的完整內(nèi)容。備份完成后建議在 Script Editor 里打印出備份路徑。清理后一旦發(fā)現(xiàn)材質(zhì)變黑、綁定失效、動(dòng)畫(huà)曲線丟失不要繼續(xù)嘗試恢復(fù)直接打開(kāi)備份版本重新處理。這一步就是場(chǎng)景清理里的“后悔藥”。4. 掃描垃圾節(jié)點(diǎn)先診斷再開(kāi)刀在沒(méi)有理解場(chǎng)景結(jié)構(gòu)之前不要直接刪除。第一步是掃描并打印候選節(jié)點(diǎn)。這里最基礎(chǔ)的檢查命令是cmds.ls(typeunknown)它會(huì)列出場(chǎng)景中所有類型無(wú)法識(shí)別的節(jié)點(diǎn)。從設(shè)計(jì)上講清理工具的第一步要做四類檢查unknown 節(jié)點(diǎn)cmds.ls(typeunknown)孤立 shadingEngine查詢每個(gè) shadingEngine 是否有dagSetMembers連接空 transform 組列出沒(méi)有子物體和 shape 的 transform引用過(guò)濾如果節(jié)點(diǎn)屬于 Reference跳過(guò)它防止誤刪參考文件里的內(nèi)容下面這個(gè)函數(shù)可以先單獨(dú)執(zhí)行觀察場(chǎng)景里有哪些問(wèn)題。注意這里只打印不刪除。# 文件路徑scripts/maya_junk_scanner.py 掃描 Maya 場(chǎng)景中常見(jiàn)的垃圾節(jié)點(diǎn)。 默認(rèn)只輸出候選不會(huì)刪除任何節(jié)點(diǎn)。 import maya.cmds as cmds def is_in_reference(node): 判斷節(jié)點(diǎn)是否來(lái)自外部 Reference。 try: if cmds.referenceQuery(node, isNodeReferencedTrue): return True except RuntimeError: pass return False def collect_unknown_nodes(): 收集 unknown 節(jié)點(diǎn)排除來(lái)自 Reference 的節(jié)點(diǎn)。 result [] for n in cmds.ls(typeunknown) or []: if not is_in_reference(n): result.append(n) return result def collect_orphan_shading_engines(): 收集沒(méi)有幾何體引用的 shadingEngine排除默認(rèn)材質(zhì)節(jié)點(diǎn)。 result [] all_sge cmds.ls(typeshadingEngine) or [] for sge in all_sge: # 系統(tǒng)初始的默認(rèn)材質(zhì)節(jié)點(diǎn)不建議清理 if sge.startswith(initialShadingGroup) or sge.startswith(initialParticleSE): continue if is_in_reference(sge): continue connections cmds.listConnections(sge .dagSetMembers) or [] if not connections: result.append(sge) return result def collect_empty_groups(): 收集沒(méi)有任何子物體和 shape 的空 transform。 注意空 transform 在動(dòng)畫(huà)約束中可能仍然有控制器作用 所以這里只作為候選輸出不要直接自動(dòng)刪除。 result [] all_transforms cmds.ls(typetransform) or [] skip_names {persp, top, side, front} for t in all_transforms: if t in skip_names: continue if is_in_reference(t): continue children cmds.listRelatives(t, childrenTrue) or [] shapes cmds.listRelatives(t, shapesTrue) or [] if not children and not shapes: result.append(t) return result def scan_scene_junk(verboseTrue): 掃描場(chǎng)景垃圾節(jié)點(diǎn)返回候選字典。 junk_map {} junk_map[unknown] collect_unknown_nodes() junk_map[orphan_shadingEngine] collect_orphan_shading_engines() junk_map[empty_groups] collect_empty_groups() if verbose: for category, items in junk_map.items(): print( {category}: {count} .format(categorycategory, countlen(items))) for item in items[:30]: print( -, item) return junk_map if __name__ __main__: scan_scene_junk()這里真正容易踩坑的地方有三個(gè)。第一unknown節(jié)點(diǎn)未必都出現(xiàn)在 Outliner 中。很多 DG 類的 unknown 節(jié)點(diǎn)只在 Hypergraph 里能看到甚至 Hypergraph 都不顯示必須用命令查詢。所以如果你在 Outliner 里沒(méi)看到不代表場(chǎng)景沒(méi)有。第二shadingEngine 的判斷不能只看名字。一個(gè)名為blinn1SG的節(jié)點(diǎn)可能是某個(gè)物體正在使用的材質(zhì)網(wǎng)絡(luò)的一部分。如果它仍然有dagSetMembers連接就說(shuō)明有幾何體在用。只有當(dāng)這個(gè)屬性完全沒(méi)有連接時(shí)它才是孤立的。第三空 transform 是一個(gè)“低風(fēng)險(xiǎn)但高敏感”的候選。一個(gè)空 group 可能被用作控制器局部坐標(biāo)的父組雖然它沒(méi)有 shape也沒(méi)有直接的子物體但它在動(dòng)畫(huà)過(guò)程里可能是大臂旋轉(zhuǎn)層級(jí)的一部分。因此這段代碼只把空組列出來(lái)不會(huì)自動(dòng)刪除。后面在執(zhí)行清理時(shí)也建議默認(rèn)排除空組除非你已經(jīng)人工檢查過(guò)。執(zhí)行這個(gè)掃描器以后輸出大致會(huì)長(zhǎng)這樣 unknown: 3 - unknown1 - rmanGlobalsNode - aiNormalNode1 orphan_shadingEngine: 2 - blinn1SG - lambert2SG empty_groups: 5 - group21 - group22 - locator10注意rmanGlobalsNode這種看起來(lái)像插件全局節(jié)點(diǎn)的對(duì)象有時(shí)候會(huì)被錯(cuò)誤地列成 unknown。如果第三方渲染插件沒(méi)有完整加載它的節(jié)點(diǎn)類型也可能顯示為 unknown。清理前需要打開(kāi)插件管理器確認(rèn)看這些插件到底有沒(méi)有被場(chǎng)景需要。如果場(chǎng)景后面還要用 RenderMan 或 Arnold 渲染那這些節(jié)點(diǎn)不能盲刪。5. 一個(gè)完整的清理腳本實(shí)現(xiàn)掃描、過(guò)濾、執(zhí)行三合一有了掃描器以后下一步是把掃描結(jié)果和刪除動(dòng)作組合起來(lái)。為了保證安全完整實(shí)現(xiàn)的默認(rèn)狀態(tài)是 dry-run只打印候選不執(zhí)行刪除。用戶檢查完候選后再切換dry_runFalse。下面給出一個(gè)可以單獨(dú)保存為maya_junk_cleaner.py的完整腳本。它與上面的掃描器不同這里把掃描、過(guò)濾、刪除動(dòng)作放在同一個(gè)類里方便直接用于生產(chǎn)環(huán)境。# 文件路徑scripts/maya_junk_cleaner.py Maya 垃圾節(jié)點(diǎn)清理工具 默認(rèn) dry_runTrue不會(huì)刪除節(jié)點(diǎn)。 確認(rèn)候選無(wú)誤后設(shè)置 dry_runFalse 再執(zhí)行。 使用方式 import maya_junk_cleaner cleaner maya_junk_cleaner.MayaJunkCleaner(dry_runTrue) cleaner.run() 真正的刪除命令 cleaner maya_junk_cleaner.MayaJunkCleaner(dry_runFalse) cleaner.run() import maya.cmds as cmds class MayaJunkCleaner(object): def __init__(self, dry_runTrue, extra_keepNone): self.dry_run dry_run self.extra_keep extra_keep or [] self.deleted [] self.skipped [] def is_in_reference(self, node): try: if cmds.referenceQuery(node, isNodeReferencedTrue): return True except RuntimeError: pass return False def should_keep(self, node): if node in self.extra_keep: return True # 系統(tǒng)級(jí)默認(rèn)節(jié)點(diǎn)千萬(wàn)不要?jiǎng)h if node.startswith(initialShadingGroup): return True if node.startswith(initialParticleSE): return True # 坐標(biāo)軸、默認(rèn)相機(jī)等不該作為垃圾清理 if node in [persp, top, side, front]: return True if self.is_in_reference(node): return True return False def collect_unknown_nodes(self): result [] for n in cmds.ls(typeunknown) or []: if not self.should_keep(n): result.append(n) return result def collect_orphan_shading_engines(self): result [] all_sge cmds.ls(typeshadingEngine) or [] for sge in all_sge: if self.should_keep(sge): continue connections cmds.listConnections(sge .dagSetMembers) or [] if not connections: result.append(sge) return result def collect_empty_groups(self): 收集空 transform但默認(rèn)不會(huì)自動(dòng)刪除。 result [] all_transforms cmds.ls(typetransform) or [] for t in all_transforms: if self.should_keep(t): continue children cmds.listRelatives(t, childrenTrue) or [] shapes cmds.listRelatives(t, shapesTrue) or [] if not children and not shapes: result.append(t) return result def delete_if_safe(self, node, reason): if node in self.deleted or node in self.skipped: return if self.should_keep(node): self.skipped.append((node, keep_by_rule)) return if self.dry_run: print([DryRun] 候選刪除{node} (原因{reason}).format( nodenode, reasonreason )) self.deleted.append(node) return try: cmds.delete(node) self.deleted.append(node) print([刪除] {node} (原因{reason}).format( nodenode, reasonreason )) except Exception as exc: self.skipped.append((node, str(exc))) print([跳過(guò)] {node} 刪除失敗{exc}.format( nodenode, excexc )) def run(self): print( * 60) print(Maya 垃圾節(jié)點(diǎn)清理工具) print(DryRun 模式{}.format(self.dry_run)) print( * 60) # 1. 刪除 unknown 節(jié)點(diǎn) for n in self.collect_unknown_nodes(): self.delete_if_safe(n, unknown_node) # 2. 刪除沒(méi)有幾何體引用的 shadingEngine for n in self.collect_orphan_shading_engines(): self.delete_if_safe(n, orphan_shadingEngine) # 3. 空 transform 組默認(rèn)只打印候選不刪除 empty_groups self.collect_empty_groups() if empty_groups: print([提醒] 發(fā)現(xiàn)空組 {} 個(gè)默認(rèn)不會(huì)刪除請(qǐng)人工確認(rèn).format(len(empty_groups))) for g in empty_groups[:30]: print( -, g) print( * 60) if self.dry_run: print(DryRun 結(jié)束。候選刪除節(jié)點(diǎn)數(shù){}.format(len(self.deleted))) print(請(qǐng)檢查上方列表確認(rèn)無(wú)誤后在實(shí)例化時(shí)設(shè)置 dry_runFalse 再執(zhí)行。) else: print(清理完成。已刪除節(jié)點(diǎn)數(shù){}跳過(guò)節(jié)點(diǎn)數(shù){}.format( len(self.deleted), len(self.skipped) )) print( * 60) if __name__ __main__: cleaner MayaJunkCleaner(dry_runTrue) cleaner.run()這段代碼的可取之處在于把“自動(dòng)判斷”和“人工決策”分離。它自動(dòng)刪除兩類相對(duì)安全的節(jié)點(diǎn)一類是 unknown 節(jié)點(diǎn)另一類是沒(méi)有幾何體引用的 shadingEngine?？战M只給候選不自動(dòng)刪除因?yàn)榭战M有可能是一個(gè)控制器的根組。如果你發(fā)現(xiàn)場(chǎng)景里確實(shí)存在不會(huì)被自動(dòng)刪除的“無(wú)效空組”可以在確認(rèn)后把空組名加入到一個(gè) allow list再單獨(dú)執(zhí)行import maya.cmds as cmds # 手動(dòng)確認(rèn)后刪除指定空組 for g in [group21, group22]: if cmds.objExists(g): cmds.delete(g) print(刪除空組, g)但這里要再次提醒group21這類名字非常容易重復(fù)使用刪除之前先確認(rèn)它是否在綁定角色身上。如果你是在一個(gè)角色綁定的場(chǎng)景里工作尤其是在處理控制器結(jié)構(gòu)空組刪除寧可保守一點(diǎn)也不要為了文件“看起來(lái)更干凈”而冒險(xiǎn)。6. 把清理工具集成到 Maya Shelf腳本文件寫好以后每次在 Script Editor 里粘代碼并不方便。比較穩(wěn)定的用法是把腳本放到 Maya 的 scripts 目錄中然后在場(chǎng)景里通過(guò)一行命令觸發(fā)。先找到當(dāng)前 Maya 環(huán)境的 scripts 路徑。在 Script Editor 的 Python Tab 里執(zhí)行import sys for p in sys.path: print(p)把maya_junk_cleaner.py放到其中一個(gè)目錄中。一般情況下Windows 路徑類似C:\Users\你的用戶名\Documents\maya\scriptsmacOS 或 Linux 可以在~/Documents/maya/scripts下找到。沒(méi)有這個(gè)目錄就自己新建一個(gè)。放到目錄之后在 Script Editor 里執(zhí)行觸發(fā)命令import maya_junk_cleaner cleaner maya_junk_cleaner.MayaJunkCleaner(dry_runTrue) cleaner.run()第一次先跑 dry-run確認(rèn)候選列表。列表里沒(méi)有需要保留的節(jié)點(diǎn)后再執(zhí)行正式清理import maya_junk_cleaner cleaner maya_junk_cleaner.MayaJunkCleaner(dry_runFalse) cleaner.run()如果你希望以后每次修改腳本后不用重啟 Maya可以使用importlib.reload重新加載模塊。下面的代碼可以做成 Shelf 按鈕的 Command 內(nèi)容try: from importlib import reload except ImportError: pass import maya_junk_cleaner reload(maya_junk_cleaner) cleaner maya_junk_cleaner.MayaJunkCleaner(dry_runFalse) cleaner.run()添加 Shelf 按鈕的方式很簡(jiǎn)單在 Maya 的 Shelf 上右鍵選擇 “Shelf Editor”新建一個(gè)按鈕把上面的命令粘到按鈕的 Command 輸入框中Label 寫CleanJunk或者清垃圾然后點(diǎn)擊保存。后續(xù)再打開(kāi)臟場(chǎng)景時(shí)點(diǎn)一下這個(gè)按鈕就可以執(zhí)行清理流程。需要注意Shelf 按鈕里面的代碼是一次性執(zhí)行代碼不是文件路徑。所以不要把 Python 代碼保存成.py文件后只寫文件名Maya 不會(huì)自動(dòng)去找那個(gè)文件必須用import語(yǔ)句導(dǎo)入模塊然后再調(diào)用。7. 清理后的效果驗(yàn)證不能只看文件變小執(zhí)行完清理以后不要急著認(rèn)為“文件變小了就是成功”。清理工具的意義在于讓場(chǎng)景網(wǎng)絡(luò)健康文件大小只是附加成果。真正的驗(yàn)證要看場(chǎng)景功能是否完整。第一步重新執(zhí)行掃描器確認(rèn) unknown 節(jié)點(diǎn)和孤立 shadingEngine 數(shù)量回到合理范圍?？梢栽?Script Editor 里執(zhí)行一次快速統(tǒng)計(jì)import maya.cmds as cmds unknown_count len(cmds.ls(typeunknown) or []) sge_count len(cmds.ls(typeshadingEngine) or []) print(剩余 unknown 節(jié)點(diǎn), unknown_count) print(剩余 shadingEngine 節(jié)點(diǎn), sge_count)第二步保存場(chǎng)景并另存為新文件。使用File Save As不要覆蓋原來(lái)的備份文件。另存后觀察文件體積是否明顯減小但這只是參考不是唯一標(biāo)準(zhǔn)。第三步檢查材質(zhì)顯示。創(chuàng)建一個(gè)簡(jiǎn)單 cuboid賦予一個(gè)基礎(chǔ) Lambert 或 Blinn 材質(zhì)確認(rèn)渲染視圖里能正常顯示顏色。檢查每個(gè)有材質(zhì)物體的 Hypershade 網(wǎng)絡(luò)確認(rèn)材質(zhì)沒(méi)有被誤刪。如果你的場(chǎng)景使用 Arnold、RenderMan 或 Redshift需要再打開(kāi)對(duì)應(yīng)渲染器的渲染視圖刷新一次確認(rèn)渲染節(jié)點(diǎn)沒(méi)有被清理掉。第四步檢查綁定和動(dòng)畫(huà)。如果場(chǎng)景里有角色綁定注意以下幾個(gè)點(diǎn)控制器是否還能正常旋轉(zhuǎn)、移動(dòng)、縮放。時(shí)間軸上的關(guān)鍵幀是否完整。Graph Editor 里是否出現(xiàn)針對(duì)已刪除節(jié)點(diǎn)的動(dòng)畫(huà)曲線。約束節(jié)點(diǎn)是否報(bào)錯(cuò)尤其使用 pointConstraint、orientConstraint 的控制關(guān)系。假如在綁定場(chǎng)景里清理后出現(xiàn)“控制器不能動(dòng)”或“角色一下子回到 bind pose”多半是誤刪了綁定網(wǎng)絡(luò)里的 utility 節(jié)點(diǎn)或 expression。此時(shí)最安全的恢復(fù)辦法是打開(kāi)第 3 節(jié)生成的備份文件不要試圖在當(dāng)前文件里手工補(bǔ)節(jié)點(diǎn)。第五步從 Outliner 和 Hypergraph 兩個(gè)維度做人工檢查。Outliner 保證 DAG 層級(jí)干凈Hypergraph 看 DG 節(jié)點(diǎn)連接。雖然自動(dòng)腳本能解決大部分問(wèn)題但最終判斷還是需要制作人員確認(rèn)?？梢源蜷_(kāi) Hypergraph → Input and Output Connections隨機(jī)檢查幾個(gè)主要物體的上下游連接確認(rèn)網(wǎng)絡(luò)結(jié)構(gòu)沒(méi)有斷。如果清理后的效果一切正常再提交給下游環(huán)節(jié)。推薦把驗(yàn)證結(jié)果記錄到文件或交付說(shuō)明里寫清楚執(zhí)行了哪些清理規(guī)則、刪除了多少節(jié)點(diǎn)。這對(duì)接手的模型師、綁定師很有價(jià)值。8. 常見(jiàn)誤刪問(wèn)題與排查思路清理節(jié)點(diǎn)時(shí)最常遇到的問(wèn)題不是腳本不存在而是腳本刪了不該刪的東西。下面把常見(jiàn)問(wèn)題和排查方式整理成表。問(wèn)題現(xiàn)象可能原因排查方式解決方案清理后材質(zhì)變黑或丟失誤刪了仍在使用的 shadingEngine打開(kāi)備份文件確認(rèn)清理前哪些材質(zhì)被渲染恢復(fù)備份并把仍在使用的材質(zhì)加入 extra_keep 列表控制器無(wú)法移動(dòng)刪除了 expression、約束節(jié)點(diǎn)或動(dòng)畫(huà)曲線查看 Script Editor 報(bào)錯(cuò)定位報(bào)錯(cuò)節(jié)點(diǎn)恢復(fù)備份在清理規(guī)則中排除動(dòng)畫(huà)/約束相關(guān)節(jié)點(diǎn)清理后 unknown 節(jié)點(diǎn)又出現(xiàn)插件每次打開(kāi)場(chǎng)景都會(huì)創(chuàng)建節(jié)點(diǎn)查看插件腳本確認(rèn)是否有啟動(dòng)腳本在生成未知節(jié)點(diǎn)不要只靠腳本刪要找到創(chuàng)建源并處理文件體積沒(méi)明顯變化主要垃圾不是 unknown 或 shadingEngine重新掃描場(chǎng)景檢查歷史記錄和引用文件使用 file Clean Up 處理歷史或單獨(dú)處理 Reference引用文件里的節(jié)點(diǎn)被刪除清理腳本沒(méi)有正確過(guò)濾 Reference檢查節(jié)點(diǎn)是否屬于 reference使用 referenceQuery 確認(rèn)恢復(fù)備份并確保 is_in_reference 檢查對(duì)所有候選節(jié)點(diǎn)生效場(chǎng)景打開(kāi)速度仍然很慢垃圾節(jié)點(diǎn)只是部分原因還有貼圖路徑或緩存問(wèn)題檢查紋理文件路徑檢查磁盤緩存打開(kāi) Hypershade 檢查貼圖路徑清理無(wú)效 file 節(jié)點(diǎn)空組刪除后綁定變形出錯(cuò)空組實(shí)際上是控制器的父級(jí)或約束參考組回滾備份在 outliner 中檢查控制器依賴空組默認(rèn)不刪改為人工確認(rèn)后再處理從實(shí)際項(xiàng)目經(jīng)驗(yàn)來(lái)看extra_keep列表非常重要。如果場(chǎng)景里有核心角色或?qū)Ｓ觅Y產(chǎn)在調(diào)用MayaJunkCleaner時(shí)可以把關(guān)鍵節(jié)點(diǎn)名傳進(jìn)去import maya_junk_cleaner cleaner maya_junk_cleaner.MayaJunkCleaner( dry_runFalse, extra_keep[character_root, rig_global_ctrl, shader_hero] ) cleaner.run()如果某項(xiàng)清理規(guī)則觸發(fā)了“未知的刪除風(fēng)險(xiǎn)”最好將這一項(xiàng)從默認(rèn)清理中排除留到單獨(dú)的人工清理步驟去處理。不要指望一條腳本能覆蓋所有情況。比如 locator有些是用來(lái)做 Aim Constraint 的瞄準(zhǔn)點(diǎn)自動(dòng)刪除后控制器的朝向就亂了。再比如 expression可能連著某個(gè)只讀屬性的驅(qū)動(dòng)刪掉之后屬性就失去動(dòng)態(tài)效果。在排查問(wèn)題上最重要的一條原則永遠(yuǎn)是刪除前看引用刪除后看報(bào)錯(cuò)真不行就恢復(fù)備份。備份是所有清理流程的底線沒(méi)有備份的清理腳本都等于在走鋼絲。9. 最佳實(shí)踐從“一次清理”到“場(chǎng)景治理”單獨(dú)寫一個(gè)清理腳本并不難難的是讓團(tuán)隊(duì)里的所有人都能在合適時(shí)機(jī)使用它。以下幾項(xiàng)實(shí)踐建議可以直接用在工作流中。第一把“清理動(dòng)作”放在“變體交付”之前。模型師提交模型前、綁定師發(fā)布綁定前、動(dòng)畫(huà)師回交文件前都應(yīng)該執(zhí)行一次清理。如果能配合版本管理最好在提交版本上自動(dòng)標(biāo)記“清理節(jié)點(diǎn)數(shù)量”和“剩余未知節(jié)點(diǎn)數(shù)量”。這會(huì)讓下游更信任文件的干凈程度。第二把清理腳本做成最保守默認(rèn)。剛開(kāi)始推廣時(shí)把所有自動(dòng)刪除都設(shè)為 dry-run團(tuán)隊(duì)成員先觀察候選列表一周再根據(jù)需求調(diào)整刪除策略。不要在第一天就把全部規(guī)則打開(kāi)否則誤刪事故會(huì)降低團(tuán)隊(duì)對(duì)腳本的信任。第三不要依賴單一清理方式。Maya 自帶的 Optimize Scene Size 對(duì)部分已知類型有用但不能完全替代 unknown 和 shadingEngine 檢查。自己的 Maya場(chǎng)景卡頓優(yōu)化：用Python精準(zhǔn)清除隱藏垃圾節(jié)點(diǎn)
最近接手一個(gè)從上游拿來(lái)的動(dòng)畫(huà)場(chǎng)景打開(kāi) Maya 之后等了快兩分鐘拖一下時(shí)間軸都感覺(jué)被“粘住”把 Outliner 里能看到的物體七七八八刪得差不多還是不見(jiàn)好轉(zhuǎn)。后來(lái)在 Script Editor 里查了一遍才發(fā)現(xiàn)場(chǎng)景里躺著幾十個(gè) unknown 節(jié)點(diǎn)、一堆沒(méi)有任何幾何體引用的 shadingEngine還有些連 Outliner 都不會(huì)顯示的孤立 expression。這類問(wèn)題在綁定、燈光和渲染環(huán)節(jié)特別常見(jiàn)。很多人以為“清理文件”就是把 Outliner 里的無(wú)用物體刪掉或者用一次“Optimize Scene Size”就了事。真正的垃圾節(jié)點(diǎn)往往藏在你看不見(jiàn)的 DG 層里肉眼和手工都很難發(fā)現(xiàn)。本文會(huì)從 Maya 節(jié)點(diǎn)的底層機(jī)制講起分析垃圾節(jié)點(diǎn)為什么會(huì)產(chǎn)生再給出一套“先掃描、再備份、后清理、可驗(yàn)證”的 Python 完整方案。文章里的代碼允許你先 dry-run只打印候選節(jié)點(diǎn)不執(zhí)行任何刪除。確認(rèn)無(wú)誤后再切換為真正清理降低誤刪材質(zhì)和綁定結(jié)構(gòu)的風(fēng)險(xiǎn)。讀完你至少能自己做一個(gè)小而穩(wěn)的 Maya 文件清理工具。1. Maya 里的“垃圾節(jié)點(diǎn)”到底是什么先解釋一個(gè)很容易被忽略的事實(shí)Maya 并不是用“物體”來(lái)管理場(chǎng)景的Maya 的全部?jī)?nèi)容都是節(jié)點(diǎn)Node靠節(jié)點(diǎn)之間的連接關(guān)系形成場(chǎng)景網(wǎng)絡(luò)。也就是說(shuō)你在 Outliner 里看到的模型、燈光、攝像機(jī)只是節(jié)點(diǎn)網(wǎng)絡(luò)里的很小一部分表現(xiàn)。大量負(fù)責(zé)數(shù)據(jù)計(jì)算、材質(zhì)分配、約束控制的節(jié)點(diǎn)并不會(huì)直接顯示在 Outliner 中。Maya 節(jié)點(diǎn)大致分成兩類DAG 節(jié)點(diǎn)存在于場(chǎng)景層級(jí)里的節(jié)點(diǎn)比如 Transform、Shape、Joint。DG 節(jié)點(diǎn)存在于依賴圖里的節(jié)點(diǎn)比如 ShadingEngine、Expression、Utility 節(jié)點(diǎn)。DG 節(jié)點(diǎn)不直接出現(xiàn)在 Outliner 的默認(rèn)視圖里但它們可能占據(jù)大量文件體積和內(nèi)存。所謂“垃圾節(jié)點(diǎn)”通常不是指某個(gè)節(jié)點(diǎn)類型本身低劣而是指這些節(jié)點(diǎn)在場(chǎng)景中已經(jīng)沒(méi)有任何實(shí)際用途卻仍然被保存下來(lái)。常見(jiàn)類型可以整理成一張表垃圾節(jié)點(diǎn)類型通常位置主要來(lái)源誤刪風(fēng)險(xiǎn)unknown / unknownDag 節(jié)點(diǎn)Outliner 不顯示插件卸載、版本轉(zhuǎn)換中低若插件后續(xù)要裝回則需謹(jǐn)慎孤立 shadingEngineHypershade 中可見(jiàn)刪除物體后材質(zhì)網(wǎng)絡(luò)殘留中可能牽連使用中的材質(zhì)孤立 expression / utility 節(jié)點(diǎn)不直觀刪除控制器后保留表達(dá)式中可能被表達(dá)式或驅(qū)動(dòng)關(guān)鍵幀引用空 transform / groupOutliner 可見(jiàn)手動(dòng)重建、復(fù)制殘留中低但空組可能是控制器父組動(dòng)畫(huà)曲線或 animLayer 殘留Graph Editor 可見(jiàn)斷開(kāi)動(dòng)畫(huà)后遺留中避免誤刪引用動(dòng)畫(huà)從實(shí)際項(xiàng)目角度看垃圾節(jié)點(diǎn)會(huì)造成幾個(gè)直接結(jié)果一是文件打開(kāi)和保存變慢二是時(shí)間軸播放和視口操作卡頓三是交接時(shí)下游不知道哪些節(jié)點(diǎn)可以刪四是在渲染農(nóng)場(chǎng)提交任務(wù)時(shí)會(huì)把無(wú)用節(jié)點(diǎn)一并帶過(guò)去增加傳輸和解析成本。所以這里有一個(gè)判斷清理垃圾節(jié)點(diǎn)不是追求“文件變小”這種表面效果而是讓場(chǎng)景網(wǎng)絡(luò)恢復(fù)健康保證后續(xù)制作和交付環(huán)節(jié)不被無(wú)意義的節(jié)點(diǎn)拖累。一個(gè)穩(wěn)定的清除流程應(yīng)該先搞清楚節(jié)點(diǎn)是屬于 DAG 還是 DG再判斷是否“被引用”最后才決定是否刪除。2. 垃圾節(jié)點(diǎn)為什么清理不干凈常見(jiàn)來(lái)源與誤區(qū)如果只是偶爾清理一次很多團(tuán)隊(duì)會(huì)發(fā)現(xiàn)一個(gè)問(wèn)題隔幾周場(chǎng)景又變大了又出現(xiàn)一堆陌生節(jié)點(diǎn)。這說(shuō)明垃圾節(jié)點(diǎn)的源頭沒(méi)有處理干凈。從材料看垃圾節(jié)點(diǎn)在模型綁定、動(dòng)畫(huà)和渲染流程里反復(fù)出現(xiàn)主要有幾個(gè)來(lái)源第一反復(fù)導(dǎo)入?yún)⒖嘉募蚝喜⑼獠繄?chǎng)景會(huì)導(dǎo)致節(jié)點(diǎn)帶有 namespace之后移除 namespace 時(shí)網(wǎng)絡(luò)連接并沒(méi)有完全清理留下大量孤立 DAG 和 DG 節(jié)點(diǎn)。比如 FBX 導(dǎo)入、Alembic 導(dǎo)入都很容易在材質(zhì)和變形器層面留下多余節(jié)點(diǎn)。第二引用文件卸載不徹底。Maya 的 Reference 機(jī)制會(huì)把被引用內(nèi)容當(dāng)作一個(gè)節(jié)點(diǎn)網(wǎng)絡(luò)加載進(jìn)來(lái)。如果只是執(zhí)行了 Unload Reference而沒(méi)有真正移除或 delete reference后續(xù)該 Reference 里的節(jié)點(diǎn)仍然可能殘留在場(chǎng)景文件中。第三插件卸載后節(jié)點(diǎn)類型丟失。如果場(chǎng)景里使用了第三方插件創(chuàng)建的節(jié)點(diǎn)而打開(kāi)場(chǎng)景的機(jī)器沒(méi)有安裝該插件Maya 會(huì)把這類節(jié)點(diǎn)標(biāo)記為 unknown。表面上看它還在但 Maya 不認(rèn)識(shí)它的具體類型也無(wú)法正常處理它的連接。很多人想清理 unknown 節(jié)點(diǎn)卻又擔(dān)心插件后續(xù)還要裝回來(lái)所以越積越多。第四手動(dòng)刪除物體時(shí)沒(méi)有清理材質(zhì)和渲染節(jié)點(diǎn)。例如刪除了一個(gè)角色模型但它的材質(zhì)網(wǎng)絡(luò)、shadingEngine、貼圖節(jié)點(diǎn)可能仍然留在 Hypershade 中。再有就是綁定過(guò)程中復(fù)制了很多 locator 和 group最后一版沒(méi)有用到但沒(méi)人去刪。很多新手會(huì)陷入一個(gè)誤區(qū)只要 Outliner 里看不見(jiàn)就認(rèn)為文件是干凈的。真正的垃圾很多是看不見(jiàn)的 DG 節(jié)點(diǎn)。另一個(gè)誤區(qū)是“清理就像刪除不用的文件直接選中刪除就行”。但 Maya 里節(jié)點(diǎn)之間存在大量隱藏連接一個(gè)看似獨(dú)立的節(jié)點(diǎn)可能在連接編輯器里被表達(dá)式、驅(qū)動(dòng)關(guān)鍵幀或引用文件引用。如果不過(guò)濾引用不檢查連接很容易刪掉后續(xù)還要使用的數(shù)據(jù)。這也是為什么本文的方案會(huì)刻意做成四個(gè)階段掃描、備份、dry-run、執(zhí)行清理。先讓腳本告訴你有哪些候選再由你判斷是否需要清理而不是讓腳本把所有可疑節(jié)點(diǎn)全部一把梭刪掉。3. 清理前先備份給場(chǎng)景吃“后悔藥”無(wú)論腳本寫得多安全刪除操作都具有不可逆性。在進(jìn)入清理之前必須先給當(dāng)前場(chǎng)景做一次備份。這里說(shuō)的備份不是“心智上的記住”而是實(shí)際生成一個(gè)帶時(shí)間戳的文件副本放在當(dāng)前場(chǎng)景旁邊。在 Maya 里執(zhí)行 Python 腳本前先手動(dòng)保存一次場(chǎng)景。下面的代碼會(huì)讀取當(dāng)前 Maya 場(chǎng)景路徑復(fù)制它到一個(gè)新文件文件名帶上before_clean標(biāo)記和時(shí)間戳。這樣如果清理后發(fā)現(xiàn)問(wèn)題可以直接打開(kāi)備份版本恢復(fù)。# 文件路徑examples/maya_scene_cleaner.py 清理前備份工具 在 Maya Script Editor 中執(zhí)行會(huì)復(fù)制當(dāng)前場(chǎng)景到同級(jí)目錄。 import os import shutil import datetime import maya.cmds as cmds def backup_current_scene(): current_scene cmds.file(queryTrue, sceneNameTrue) if not current_scene or not os.path.exists(current_scene): cmds.warning(當(dāng)前場(chǎng)景尚未保存請(qǐng)先保存后再執(zhí)行備份。) return None base, ext os.path.splitext(current_scene) stamp datetime.datetime.now().strftime(%Y%m%d_%H%M%S) backup_path {base}_before_clean_{stamp}{ext}.format( basebase, stampstamp, extext or .ma ) try: shutil.copy2(current_scene, backup_path) print(備份完成{path}.format(pathbackup_path)) except Exception as exc: cmds.error(備份失敗{}.format(exc)) return None return backup_path if __name__ __main__: backup_path backup_current_scene() if backup_path: cmds.confirmDialog( title備份完成, message場(chǎng)景備份成功。\n{}.format(backup_path), button[確定], defaultButton確定, )這段代碼里的關(guān)鍵點(diǎn)是使用cmds.file(queryTrue, sceneNameTrue)獲取當(dāng)前路徑而不是自己拼接路徑。對(duì)于.ma和.mb格式都適用。接著用os.path.splitext分離文件名和后綴生成xxx_before_clean_20250214_153000.ma這樣的備份副本。需要注意如果當(dāng)前場(chǎng)景還沒(méi)保存過(guò)sceneName返回為空代碼會(huì)中止并提示先保存。不要嘗試在未保存狀態(tài)下直接復(fù)制臨時(shí)文件因?yàn)?Maya 的臨時(shí)文件未必等于當(dāng)前場(chǎng)景的完整內(nèi)容。備份完成后建議在 Script Editor 里打印出備份路徑。清理后一旦發(fā)現(xiàn)材質(zhì)變黑、綁定失效、動(dòng)畫(huà)曲線丟失不要繼續(xù)嘗試恢復(fù)直接打開(kāi)備份版本重新處理。這一步就是場(chǎng)景清理里的“后悔藥”。4. 掃描垃圾節(jié)點(diǎn)先診斷再開(kāi)刀在沒(méi)有理解場(chǎng)景結(jié)構(gòu)之前不要直接刪除。第一步是掃描并打印候選節(jié)點(diǎn)。這里最基礎(chǔ)的檢查命令是cmds.ls(typeunknown)它會(huì)列出場(chǎng)景中所有類型無(wú)法識(shí)別的節(jié)點(diǎn)。從設(shè)計(jì)上講清理工具的第一步要做四類檢查unknown 節(jié)點(diǎn)cmds.ls(typeunknown)孤立 shadingEngine查詢每個(gè) shadingEngine 是否有dagSetMembers連接空 transform 組列出沒(méi)有子物體和 shape 的 transform引用過(guò)濾如果節(jié)點(diǎn)屬于 Reference跳過(guò)它防止誤刪參考文件里的內(nèi)容下面這個(gè)函數(shù)可以先單獨(dú)執(zhí)行觀察場(chǎng)景里有哪些問(wèn)題。注意這里只打印不刪除。# 文件路徑scripts/maya_junk_scanner.py 掃描 Maya 場(chǎng)景中常見(jiàn)的垃圾節(jié)點(diǎn)。 默認(rèn)只輸出候選不會(huì)刪除任何節(jié)點(diǎn)。 import maya.cmds as cmds def is_in_reference(node): 判斷節(jié)點(diǎn)是否來(lái)自外部 Reference。 try: if cmds.referenceQuery(node, isNodeReferencedTrue): return True except RuntimeError: pass return False def collect_unknown_nodes(): 收集 unknown 節(jié)點(diǎn)排除來(lái)自 Reference 的節(jié)點(diǎn)。 result [] for n in cmds.ls(typeunknown) or []: if not is_in_reference(n): result.append(n) return result def collect_orphan_shading_engines(): 收集沒(méi)有幾何體引用的 shadingEngine排除默認(rèn)材質(zhì)節(jié)點(diǎn)。 result [] all_sge cmds.ls(typeshadingEngine) or [] for sge in all_sge: # 系統(tǒng)初始的默認(rèn)材質(zhì)節(jié)點(diǎn)不建議清理 if sge.startswith(initialShadingGroup) or sge.startswith(initialParticleSE): continue if is_in_reference(sge): continue connections cmds.listConnections(sge .dagSetMembers) or [] if not connections: result.append(sge) return result def collect_empty_groups(): 收集沒(méi)有任何子物體和 shape 的空 transform。 注意空 transform 在動(dòng)畫(huà)約束中可能仍然有控制器作用 所以這里只作為候選輸出不要直接自動(dòng)刪除。 result [] all_transforms cmds.ls(typetransform) or [] skip_names {persp, top, side, front} for t in all_transforms: if t in skip_names: continue if is_in_reference(t): continue children cmds.listRelatives(t, childrenTrue) or [] shapes cmds.listRelatives(t, shapesTrue) or [] if not children and not shapes: result.append(t) return result def scan_scene_junk(verboseTrue): 掃描場(chǎng)景垃圾節(jié)點(diǎn)返回候選字典。 junk_map {} junk_map[unknown] collect_unknown_nodes() junk_map[orphan_shadingEngine] collect_orphan_shading_engines() junk_map[empty_groups] collect_empty_groups() if verbose: for category, items in junk_map.items(): print( {category}: {count} .format(categorycategory, countlen(items))) for item in items[:30]: print( -, item) return junk_map if __name__ __main__: scan_scene_junk()這里真正容易踩坑的地方有三個(gè)。第一unknown節(jié)點(diǎn)未必都出現(xiàn)在 Outliner 中。很多 DG 類的 unknown 節(jié)點(diǎn)只在 Hypergraph 里能看到甚至 Hypergraph 都不顯示必須用命令查詢。所以如果你在 Outliner 里沒(méi)看到不代表場(chǎng)景沒(méi)有。第二shadingEngine 的判斷不能只看名字。一個(gè)名為blinn1SG的節(jié)點(diǎn)可能是某個(gè)物體正在使用的材質(zhì)網(wǎng)絡(luò)的一部分。如果它仍然有dagSetMembers連接就說(shuō)明有幾何體在用。只有當(dāng)這個(gè)屬性完全沒(méi)有連接時(shí)它才是孤立的。第三空 transform 是一個(gè)“低風(fēng)險(xiǎn)但高敏感”的候選。一個(gè)空 group 可能被用作控制器局部坐標(biāo)的父組雖然它沒(méi)有 shape也沒(méi)有直接的子物體但它在動(dòng)畫(huà)過(guò)程里可能是大臂旋轉(zhuǎn)層級(jí)的一部分。因此這段代碼只把空組列出來(lái)不會(huì)自動(dòng)刪除。后面在執(zhí)行清理時(shí)也建議默認(rèn)排除空組除非你已經(jīng)人工檢查過(guò)。執(zhí)行這個(gè)掃描器以后輸出大致會(huì)長(zhǎng)這樣 unknown: 3 - unknown1 - rmanGlobalsNode - aiNormalNode1 orphan_shadingEngine: 2 - blinn1SG - lambert2SG empty_groups: 5 - group21 - group22 - locator10注意rmanGlobalsNode這種看起來(lái)像插件全局節(jié)點(diǎn)的對(duì)象有時(shí)候會(huì)被錯(cuò)誤地列成 unknown。如果第三方渲染插件沒(méi)有完整加載它的節(jié)點(diǎn)類型也可能顯示為 unknown。清理前需要打開(kāi)插件管理器確認(rèn)看這些插件到底有沒(méi)有被場(chǎng)景需要。如果場(chǎng)景后面還要用 RenderMan 或 Arnold 渲染那這些節(jié)點(diǎn)不能盲刪。5. 一個(gè)完整的清理腳本實(shí)現(xiàn)掃描、過(guò)濾、執(zhí)行三合一有了掃描器以后下一步是把掃描結(jié)果和刪除動(dòng)作組合起來(lái)。為了保證安全完整實(shí)現(xiàn)的默認(rèn)狀態(tài)是 dry-run只打印候選不執(zhí)行刪除。用戶檢查完候選后再切換dry_runFalse。下面給出一個(gè)可以單獨(dú)保存為maya_junk_cleaner.py的完整腳本。它與上面的掃描器不同這里把掃描、過(guò)濾、刪除動(dòng)作放在同一個(gè)類里方便直接用于生產(chǎn)環(huán)境。# 文件路徑scripts/maya_junk_cleaner.py Maya 垃圾節(jié)點(diǎn)清理工具 默認(rèn) dry_runTrue不會(huì)刪除節(jié)點(diǎn)。 確認(rèn)候選無(wú)誤后設(shè)置 dry_runFalse 再執(zhí)行。 使用方式 import maya_junk_cleaner cleaner maya_junk_cleaner.MayaJunkCleaner(dry_runTrue) cleaner.run() 真正的刪除命令 cleaner maya_junk_cleaner.MayaJunkCleaner(dry_runFalse) cleaner.run() import maya.cmds as cmds class MayaJunkCleaner(object): def __init__(self, dry_runTrue, extra_keepNone): self.dry_run dry_run self.extra_keep extra_keep or [] self.deleted [] self.skipped [] def is_in_reference(self, node): try: if cmds.referenceQuery(node, isNodeReferencedTrue): return True except RuntimeError: pass return False def should_keep(self, node): if node in self.extra_keep: return True # 系統(tǒng)級(jí)默認(rèn)節(jié)點(diǎn)千萬(wàn)不要?jiǎng)h if node.startswith(initialShadingGroup): return True if node.startswith(initialParticleSE): return True # 坐標(biāo)軸、默認(rèn)相機(jī)等不該作為垃圾清理 if node in [persp, top, side, front]: return True if self.is_in_reference(node): return True return False def collect_unknown_nodes(self): result [] for n in cmds.ls(typeunknown) or []: if not self.should_keep(n): result.append(n) return result def collect_orphan_shading_engines(self): result [] all_sge cmds.ls(typeshadingEngine) or [] for sge in all_sge: if self.should_keep(sge): continue connections cmds.listConnections(sge .dagSetMembers) or [] if not connections: result.append(sge) return result def collect_empty_groups(self): 收集空 transform但默認(rèn)不會(huì)自動(dòng)刪除。 result [] all_transforms cmds.ls(typetransform) or [] for t in all_transforms: if self.should_keep(t): continue children cmds.listRelatives(t, childrenTrue) or [] shapes cmds.listRelatives(t, shapesTrue) or [] if not children and not shapes: result.append(t) return result def delete_if_safe(self, node, reason): if node in self.deleted or node in self.skipped: return if self.should_keep(node): self.skipped.append((node, keep_by_rule)) return if self.dry_run: print([DryRun] 候選刪除{node} (原因{reason}).format( nodenode, reasonreason )) self.deleted.append(node) return try: cmds.delete(node) self.deleted.append(node) print([刪除] {node} (原因{reason}).format( nodenode, reasonreason )) except Exception as exc: self.skipped.append((node, str(exc))) print([跳過(guò)] {node} 刪除失敗{exc}.format( nodenode, excexc )) def run(self): print( * 60) print(Maya 垃圾節(jié)點(diǎn)清理工具) print(DryRun 模式{}.format(self.dry_run)) print( * 60) # 1. 刪除 unknown 節(jié)點(diǎn) for n in self.collect_unknown_nodes(): self.delete_if_safe(n, unknown_node) # 2. 刪除沒(méi)有幾何體引用的 shadingEngine for n in self.collect_orphan_shading_engines(): self.delete_if_safe(n, orphan_shadingEngine) # 3. 空 transform 組默認(rèn)只打印候選不刪除 empty_groups self.collect_empty_groups() if empty_groups: print([提醒] 發(fā)現(xiàn)空組 {} 個(gè)默認(rèn)不會(huì)刪除請(qǐng)人工確認(rèn).format(len(empty_groups))) for g in empty_groups[:30]: print( -, g) print( * 60) if self.dry_run: print(DryRun 結(jié)束。候選刪除節(jié)點(diǎn)數(shù){}.format(len(self.deleted))) print(請(qǐng)檢查上方列表確認(rèn)無(wú)誤后在實(shí)例化時(shí)設(shè)置 dry_runFalse 再執(zhí)行。) else: print(清理完成。已刪除節(jié)點(diǎn)數(shù){}跳過(guò)節(jié)點(diǎn)數(shù){}.format( len(self.deleted), len(self.skipped) )) print( * 60) if __name__ __main__: cleaner MayaJunkCleaner(dry_runTrue) cleaner.run()這段代碼的可取之處在于把“自動(dòng)判斷”和“人工決策”分離。它自動(dòng)刪除兩類相對(duì)安全的節(jié)點(diǎn)一類是 unknown 節(jié)點(diǎn)另一類是沒(méi)有幾何體引用的 shadingEngine?？战M只給候選不自動(dòng)刪除因?yàn)榭战M有可能是一個(gè)控制器的根組。如果你發(fā)現(xiàn)場(chǎng)景里確實(shí)存在不會(huì)被自動(dòng)刪除的“無(wú)效空組”可以在確認(rèn)后把空組名加入到一個(gè) allow list再單獨(dú)執(zhí)行import maya.cmds as cmds # 手動(dòng)確認(rèn)后刪除指定空組 for g in [group21, group22]: if cmds.objExists(g): cmds.delete(g) print(刪除空組, g)但這里要再次提醒group21這類名字非常容易重復(fù)使用刪除之前先確認(rèn)它是否在綁定角色身上。如果你是在一個(gè)角色綁定的場(chǎng)景里工作尤其是在處理控制器結(jié)構(gòu)空組刪除寧可保守一點(diǎn)也不要為了文件“看起來(lái)更干凈”而冒險(xiǎn)。6. 把清理工具集成到 Maya Shelf腳本文件寫好以后每次在 Script Editor 里粘代碼并不方便。比較穩(wěn)定的用法是把腳本放到 Maya 的 scripts 目錄中然后在場(chǎng)景里通過(guò)一行命令觸發(fā)。先找到當(dāng)前 Maya 環(huán)境的 scripts 路徑。在 Script Editor 的 Python Tab 里執(zhí)行import sys for p in sys.path: print(p)把maya_junk_cleaner.py放到其中一個(gè)目錄中。一般情況下Windows 路徑類似C:\Users\你的用戶名\Documents\maya\scriptsmacOS 或 Linux 可以在~/Documents/maya/scripts下找到。沒(méi)有這個(gè)目錄就自己新建一個(gè)。放到目錄之后在 Script Editor 里執(zhí)行觸發(fā)命令import maya_junk_cleaner cleaner maya_junk_cleaner.MayaJunkCleaner(dry_runTrue) cleaner.run()第一次先跑 dry-run確認(rèn)候選列表。列表里沒(méi)有需要保留的節(jié)點(diǎn)后再執(zhí)行正式清理import maya_junk_cleaner cleaner maya_junk_cleaner.MayaJunkCleaner(dry_runFalse) cleaner.run()如果你希望以后每次修改腳本后不用重啟 Maya可以使用importlib.reload重新加載模塊。下面的代碼可以做成 Shelf 按鈕的 Command 內(nèi)容try: from importlib import reload except ImportError: pass import maya_junk_cleaner reload(maya_junk_cleaner) cleaner maya_junk_cleaner.MayaJunkCleaner(dry_runFalse) cleaner.run()添加 Shelf 按鈕的方式很簡(jiǎn)單在 Maya 的 Shelf 上右鍵選擇 “Shelf Editor”新建一個(gè)按鈕把上面的命令粘到按鈕的 Command 輸入框中Label 寫CleanJunk或者清垃圾然后點(diǎn)擊保存。后續(xù)再打開(kāi)臟場(chǎng)景時(shí)點(diǎn)一下這個(gè)按鈕就可以執(zhí)行清理流程。需要注意Shelf 按鈕里面的代碼是一次性執(zhí)行代碼不是文件路徑。所以不要把 Python 代碼保存成.py文件后只寫文件名Maya 不會(huì)自動(dòng)去找那個(gè)文件必須用import語(yǔ)句導(dǎo)入模塊然后再調(diào)用。7. 清理后的效果驗(yàn)證不能只看文件變小執(zhí)行完清理以后不要急著認(rèn)為“文件變小了就是成功”。清理工具的意義在于讓場(chǎng)景網(wǎng)絡(luò)健康文件大小只是附加成果。真正的驗(yàn)證要看場(chǎng)景功能是否完整。第一步重新執(zhí)行掃描器確認(rèn) unknown 節(jié)點(diǎn)和孤立 shadingEngine 數(shù)量回到合理范圍?？梢栽?Script Editor 里執(zhí)行一次快速統(tǒng)計(jì)import maya.cmds as cmds unknown_count len(cmds.ls(typeunknown) or []) sge_count len(cmds.ls(typeshadingEngine) or []) print(剩余 unknown 節(jié)點(diǎn), unknown_count) print(剩余 shadingEngine 節(jié)點(diǎn), sge_count)第二步保存場(chǎng)景并另存為新文件。使用File Save As不要覆蓋原來(lái)的備份文件。另存后觀察文件體積是否明顯減小但這只是參考不是唯一標(biāo)準(zhǔn)。第三步檢查材質(zhì)顯示。創(chuàng)建一個(gè)簡(jiǎn)單 cuboid賦予一個(gè)基礎(chǔ) Lambert 或 Blinn 材質(zhì)確認(rèn)渲染視圖里能正常顯示顏色。檢查每個(gè)有材質(zhì)物體的 Hypershade 網(wǎng)絡(luò)確認(rèn)材質(zhì)沒(méi)有被誤刪。如果你的場(chǎng)景使用 Arnold、RenderMan 或 Redshift需要再打開(kāi)對(duì)應(yīng)渲染器的渲染視圖刷新一次確認(rèn)渲染節(jié)點(diǎn)沒(méi)有被清理掉。第四步檢查綁定和動(dòng)畫(huà)。如果場(chǎng)景里有角色綁定注意以下幾個(gè)點(diǎn)控制器是否還能正常旋轉(zhuǎn)、移動(dòng)、縮放。時(shí)間軸上的關(guān)鍵幀是否完整。Graph Editor 里是否出現(xiàn)針對(duì)已刪除節(jié)點(diǎn)的動(dòng)畫(huà)曲線。約束節(jié)點(diǎn)是否報(bào)錯(cuò)尤其使用 pointConstraint、orientConstraint 的控制關(guān)系。假如在綁定場(chǎng)景里清理后出現(xiàn)“控制器不能動(dòng)”或“角色一下子回到 bind pose”多半是誤刪了綁定網(wǎng)絡(luò)里的 utility 節(jié)點(diǎn)或 expression。此時(shí)最安全的恢復(fù)辦法是打開(kāi)第 3 節(jié)生成的備份文件不要試圖在當(dāng)前文件里手工補(bǔ)節(jié)點(diǎn)。第五步從 Outliner 和 Hypergraph 兩個(gè)維度做人工檢查。Outliner 保證 DAG 層級(jí)干凈Hypergraph 看 DG 節(jié)點(diǎn)連接。雖然自動(dòng)腳本能解決大部分問(wèn)題但最終判斷還是需要制作人員確認(rèn)?？梢源蜷_(kāi) Hypergraph → Input and Output Connections隨機(jī)檢查幾個(gè)主要物體的上下游連接確認(rèn)網(wǎng)絡(luò)結(jié)構(gòu)沒(méi)有斷。如果清理后的效果一切正常再提交給下游環(huán)節(jié)。推薦把驗(yàn)證結(jié)果記錄到文件或交付說(shuō)明里寫清楚執(zhí)行了哪些清理規(guī)則、刪除了多少節(jié)點(diǎn)。這對(duì)接手的模型師、綁定師很有價(jià)值。8. 常見(jiàn)誤刪問(wèn)題與排查思路清理節(jié)點(diǎn)時(shí)最常遇到的問(wèn)題不是腳本不存在而是腳本刪了不該刪的東西。下面把常見(jiàn)問(wèn)題和排查方式整理成表。問(wèn)題現(xiàn)象可能原因排查方式解決方案清理后材質(zhì)變黑或丟失誤刪了仍在使用的 shadingEngine打開(kāi)備份文件確認(rèn)清理前哪些材質(zhì)被渲染恢復(fù)備份并把仍在使用的材質(zhì)加入 extra_keep 列表控制器無(wú)法移動(dòng)刪除了 expression、約束節(jié)點(diǎn)或動(dòng)畫(huà)曲線查看 Script Editor 報(bào)錯(cuò)定位報(bào)錯(cuò)節(jié)點(diǎn)恢復(fù)備份在清理規(guī)則中排除動(dòng)畫(huà)/約束相關(guān)節(jié)點(diǎn)清理后 unknown 節(jié)點(diǎn)又出現(xiàn)插件每次打開(kāi)場(chǎng)景都會(huì)創(chuàng)建節(jié)點(diǎn)查看插件腳本確認(rèn)是否有啟動(dòng)腳本在生成未知節(jié)點(diǎn)不要只靠腳本刪要找到創(chuàng)建源并處理文件體積沒(méi)明顯變化主要垃圾不是 unknown 或 shadingEngine重新掃描場(chǎng)景檢查歷史記錄和引用文件使用 file Clean Up 處理歷史或單獨(dú)處理 Reference引用文件里的節(jié)點(diǎn)被刪除清理腳本沒(méi)有正確過(guò)濾 Reference檢查節(jié)點(diǎn)是否屬于 reference使用 referenceQuery 確認(rèn)恢復(fù)備份并確保 is_in_reference 檢查對(duì)所有候選節(jié)點(diǎn)生效場(chǎng)景打開(kāi)速度仍然很慢垃圾節(jié)點(diǎn)只是部分原因還有貼圖路徑或緩存問(wèn)題檢查紋理文件路徑檢查磁盤緩存打開(kāi) Hypershade 檢查貼圖路徑清理無(wú)效 file 節(jié)點(diǎn)空組刪除后綁定變形出錯(cuò)空組實(shí)際上是控制器的父級(jí)或約束參考組回滾備份在 outliner 中檢查控制器依賴空組默認(rèn)不刪改為人工確認(rèn)后再處理從實(shí)際項(xiàng)目經(jīng)驗(yàn)來(lái)看extra_keep列表非常重要。如果場(chǎng)景里有核心角色或?qū)Ｓ觅Y產(chǎn)在調(diào)用MayaJunkCleaner時(shí)可以把關(guān)鍵節(jié)點(diǎn)名傳進(jìn)去import maya_junk_cleaner cleaner maya_junk_cleaner.MayaJunkCleaner( dry_runFalse, extra_keep[character_root, rig_global_ctrl, shader_hero] ) cleaner.run()如果某項(xiàng)清理規(guī)則觸發(fā)了“未知的刪除風(fēng)險(xiǎn)”最好將這一項(xiàng)從默認(rèn)清理中排除留到單獨(dú)的人工清理步驟去處理。不要指望一條腳本能覆蓋所有情況。比如 locator有些是用來(lái)做 Aim Constraint 的瞄準(zhǔn)點(diǎn)自動(dòng)刪除后控制器的朝向就亂了。再比如 expression可能連著某個(gè)只讀屬性的驅(qū)動(dòng)刪掉之后屬性就失去動(dòng)態(tài)效果。在排查問(wèn)題上最重要的一條原則永遠(yuǎn)是刪除前看引用刪除后看報(bào)錯(cuò)真不行就恢復(fù)備份。備份是所有清理流程的底線沒(méi)有備份的清理腳本都等于在走鋼絲。9. 最佳實(shí)踐從“一次清理”到“場(chǎng)景治理”單獨(dú)寫一個(gè)清理腳本并不難難的是讓團(tuán)隊(duì)里的所有人都能在合適時(shí)機(jī)使用它。以下幾項(xiàng)實(shí)踐建議可以直接用在工作流中。第一把“清理動(dòng)作”放在“變體交付”之前。模型師提交模型前、綁定師發(fā)布綁定前、動(dòng)畫(huà)師回交文件前都應(yīng)該執(zhí)行一次清理。如果能配合版本管理最好在提交版本上自動(dòng)標(biāo)記“清理節(jié)點(diǎn)數(shù)量”和“剩余未知節(jié)點(diǎn)數(shù)量”。這會(huì)讓下游更信任文件的干凈程度。第二把清理腳本做成最保守默認(rèn)。剛開(kāi)始推廣時(shí)把所有自動(dòng)刪除都設(shè)為 dry-run團(tuán)隊(duì)成員先觀察候選列表一周再根據(jù)需求調(diào)整刪除策略。不要在第一天就把全部規(guī)則打開(kāi)否則誤刪事故會(huì)降低團(tuán)隊(duì)對(duì)腳本的信任。第三不要依賴單一清理方式。Maya 自帶的 Optimize Scene Size 對(duì)部分已知類型有用但不能完全替代 unknown 和 shadingEngine 檢查。自己的