本文详解如何使用 Maya Python API（maya.cmds.xform）以世界坐标系精确提取任意几何体顶点的三维数值坐标，并提供可直接运行的代码示例与关键注意事项。
本文详解如何使用 maya python api（`maya.cmds.xform`）以世界坐标系精确提取任意几何体顶点的三维数值坐标，并提供可直接运行的代码示例与关键注意事项。
在 Autodesk Maya 中，通过 Python 脚本获取顶点（vertex）的精确 XYZ 坐标是建模、绑定、程序化动画等流程中的常见需求。核心方法是调用 maya.cmds.xform 命令，并启用查询模式（q=True）配合 translation=True 与 worldSpace=True 参数——这确保返回的是世界空间下的绝对位置，而非局部或相对偏移值。
需注意：Maya 的底层对象引用完全基于字符串路径（如 pCube1.vtx[0] 或通配符 pCube1.vtx[*]），因此必须构造合法的组件字符串。对于命名物体 pCube1，其全部顶点的标准表示为 'pCube1.vtx[*]'；若需单个顶点，则使用 'pCube1.vtx[5]' 等具体索引。
以下为完整可执行示例：
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
import maya.cmds as cmds
# 获取 pCube1 所有顶点的世界坐标（返回扁平化列表：[x0,y0,z0,x1,y1,z1,...]）
xyzs = cmds.xform('pCube1.vtx[*]', q=True, translation=True, worldSpace=True)
if xyzs:
print(f'{len(xyzs) // 3} 个顶点坐标已获取')
for i in range(0, len(xyzs), 3):
x, y, z = xyzs[i], xyzs[i+1], xyzs[i+2]
print(f'( {x:8.3f} {y:8.3f} {z:8.3f} )')
else:
cmds.warning("未找到有效顶点或对象不存在，请检查名称与场景状态。")⚠️ 关键注意事项：
立即学习“Python免费学习笔记（深入）”；
- 确保目标物体存在且名称准确（区分大小写，支持命名空间）；
- worldSpace=True 是获取全局坐标的必要参数，遗漏将导致局部坐标（可能为零或非预期值）；
- 返回值为一维浮点数列表，每 3 个元素对应一个顶点的 (x, y, z)，务必按步长 3 解包；
- 若处理大量顶点（如高模），建议结合 cmds.getAttr('pCube1.vtx[*].worldPosition')（需先启用 .worldPosition 属性）或更高效的 OpenMaya API 实现性能优化；
- 在批量操作前，推荐用 cmds.objExists('pCube1') 和 cmds.nodeType('pCube1', apiType=True) == 'kMesh' 进行前置校验，提升脚本鲁棒性。
掌握这一模式后，可轻松扩展至边（.e[*]）、面（.f[*]）中心点或变换节点本身的坐标读取，是 Maya 自动化开发的基础能力之一。
