1. 按 G 移动的为什么是 Cursor 而不是物体你在 Blender 里选中一个立方体手指习惯性按下 G结果物体纹丝不动场景里那个红白相间的 3D Cursor 却跟着鼠标跑了起来。这不是你的键盘坏了也不是 Blender 抽风而是当前激活的工具或键位映射被改成了「移动游标」模式。Blender 的 G 键本身是一个操作符调用默认绑定到transform.translate作用对象是「当前选中元素」。但如果你之前装过某些插件、导入过别人的偏好设置或者误触了工具面板里的「Cursor」工具G 的语义就会被重定向到transform.translate的 cursor 变体上。更隐蔽的一种情况是你处于「游标工具」激活状态此时左键点击会直接放置游标G 自然也跟着游标走。这个问题在 Blender 2.8 之后变得特别常见因为工具栏T 面板把「Select Box」「Cursor」「Move」做成了互斥的激活工具。很多人从旧版迁移过来习惯用 G 做一切移动却没注意到工具栏已经悄悄切到了 Cursor。我试过最直接的排查方式按 G 之后看左下角状态栏提示。如果显示的是「Move Cursor」而不是「Move」那基本可以确定是工具或键位问题。接下来要做的不是一个个翻菜单而是用一段脚本把移动相关的配置一次性重置干净。适合谁看刚接触 Blender 的建模新手、从 2.7x 升级到 3.x/4.x 的老用户、以及装了插件后键位混乱的从业者。下面从偏好设置和脚本两个角度给出可复制的修复方案。2. 修复前的环境准备与 TaoToken 接入在动手改配置之前建议先确认你的 Blender 版本和 Python 环境。脚本修复依赖 Blender 内置的bpy模块不需要额外安装 Python但如果你打算把修复逻辑做成自动化流程、或者用外部工具批量处理多个.blend文件就需要一个稳定的 API 通道来调用模型做配置分析。TaoToken 在这里的角色是提供统一的模型调用入口。你可以把它理解成一个「配置诊断助手」把当前 Blender 的键位导出成文本丢给模型分析哪些映射被改动了再生成对应的修复脚本。对于需要长期维护多个工程文件的团队这种自动化排查比手动翻偏好设置快得多。接入方式很简单先拿到 API Key注册并登录后进入控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole在 API Keys 页面创建一个新 Keyhttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys接口地址统一用https://taotoken.net/api如果你只是想先验证模型能不能正确识别 Blender 的键位配置问题可以直接在模型对话页测试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentchat对于需要长期做 Blender 脚本开发、批量处理工程文件的用户Coding Plan 更适合https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan注意TaoToken 只负责模型调用和配置分析不替代 Blender 本身的编辑器功能。修复动作仍然在 Blender 内部完成。3. 可复制的键位配置与脚本修复步骤3.1 先手动确认问题根源打开 Blender按N调出右侧边栏切换到「Tool」标签看当前激活的工具图标是不是「Cursor」。如果是点击「Select Box」或按W切换回选择工具。然后按 G 测试如果物体开始移动说明只是工具激活状态的问题不需要跑脚本。如果切换工具后 G 仍然移动游标那就是键位映射被改了。进入Edit Preferences Keymap在搜索框输入translate找到3D View Object Mode Object Mode (Global)下的Move项确认它绑定的是G且操作符是transform.translate。如果被改成了transform.translate的 cursor 变体右键选择「Reset to Default」即可。3.2 用脚本批量重置移动相关配置手动改键位只能解决单个映射如果你之前导入过整套偏好设置可能有多处被污染。下面这段脚本会重置工具设置、变换轴心、视图朝向和输入偏好把移动行为拉回默认状态。import bpy print( 重置 Blender 移动相关配置 ) # 1. 确保处于物体模式 if bpy.context.mode ! OBJECT: bpy.ops.object.mode_set(modeOBJECT) # 2. 重置工具设置中的变换修正选项 tool_settings bpy.context.scene.tool_settings tool_settings.use_transform_correct_face_attributes False tool_settings.use_transform_correct_keep_connected False # 3. 重置变换轴心为默认的 Median Point tool_settings.transform_pivot_point MEDIAN_POINT tool_settings.use_transform_pivot_point_align False tool_settings.use_transform_data_origin False # 4. 重置 3D 视图的变换朝向和 gizmo 显示 for area in bpy.context.screen.areas: if area.type VIEW_3D: for space in area.spaces: if space.type VIEW_3D: space.transform_orientation GLOBAL space.use_local_collections False space.show_gizmo True space.show_gizmo_navigate True space.show_gizmo_tool True space.show_gizmo_context True print(已重置 3D 视图变换设置) # 5. 将活动工具切回选择框工具 try: bpy.ops.wm.tool_set_by_id(namebuiltin.select_box) print(活动工具已设为 Select Box) except Exception as e: print(f工具切换失败: {e}) # 6. 重置 3D Cursor 到世界原点 bpy.context.scene.cursor.location (0.0, 0.0, 0.0) bpy.context.scene.cursor.rotation_euler (0.0, 0.0, 0.0) print(3D Cursor 已归零) # 7. 重置输入偏好中的鼠标模拟和连续抓取 prefs bpy.context.preferences if hasattr(prefs, inputs): prefs.inputs.use_mouse_emulate_3_button False prefs.inputs.use_mouse_continuous_grab False print(输入偏好已重置) # 8. 强制刷新界面 bpy.ops.wm.redraw_timer(typeDRAW_WIN_SWAP, iterations1) print( 重置完成 ) print(请测试左键选中物体按 G确认移动的是物体而不是 Cursor)把这段代码粘贴到 Blender 的 Scripting 工作区点击运行按钮三角形图标。运行后不要急着关先按 G 测试一次。3.3 如果脚本运行后仍然异常有些插件的键位注册优先级高于默认映射脚本重置后会被插件重新覆盖。这时候需要检查Edit Preferences Add-ons里最近启用的插件尤其是那些标注了「Keymap」「Shortcut」的。临时禁用可疑插件重启 Blender 后再测试。另外Blender 4.x 对bpy.ops.wm.tool_set_by_id的参数做了调整如果你用的是 4.0 以上版本把namebuiltin.select_box改成namebuiltin.select_box仍然有效但部分构建版本可能需要用bpy.ops.wm.tool_set_by_id(namebuiltin.select)。如果报错先注释掉第 5 步手动在工具栏点一下选择工具即可。4. 验证请求与成功结果确认脚本跑完后按以下步骤验证第一步重启 Blender。这一步很关键因为部分偏好设置只在启动时加载热重置可能不生效。第二步新建一个默认场景里面会有一个立方体、一个相机和一个灯光。左键点击立方体确认它被选中轮廓变橙色。第三步按 G。此时状态栏应该显示「Move」鼠标移动时立方体跟着走3D Cursor 保持不动。如果状态栏显示的是「Move Cursor」说明键位映射还没恢复回到 3.1 节手动重置。第四步按Shift 右键手动放置一个 Cursor 到别的位置再按 G 测试物体移动。确认 Cursor 的位置不会因为 G 操作而改变。第五步如果你用 TaoToken 做了配置分析可以把重置后的键位导出成文本再让模型确认一遍。导出方式Edit Preferences Keymap Export保存为.py文件后直接读取内容。import bpy # 导出当前键位配置用于比对 keyconfig bpy.context.preferences.keymap for item in keyconfig: if translate in item.idname.lower() or cursor in item.idname.lower(): print(f映射: {item.idname} | 操作符: {item.operator} | 按键: {item.type})运行后如果看到transform.translate绑定在G上且没有 cursor 相关的覆盖项就说明修复成功。5. 本篇常见错误排查5.1 脚本报错「context is incorrect」这是因为脚本在非 3D 视图上下文中运行。解决方法先在 Blender 里把鼠标移到 3D 视图区域再切到 Scripting 工作区运行。或者把脚本开头改成import bpy # 强制切换到物体模式 if bpy.context.object and bpy.context.object.mode ! OBJECT: bpy.ops.object.mode_set(modeOBJECT)5.2 按 G 后物体移动但 Cursor 也跟着动这是use_transform_pivot_point_align被打开导致的。脚本第 3 步已经把它设为False如果还有问题手动在 3D 视图顶部的轴心菜单里确认选中的是「Median Point」而不是「3D Cursor」。5.3 重启后配置又恢复原样说明你的 Blender 启用了「自动保存偏好设置」但某个插件在启动时重新注册了键位。进入Edit Preferences Add-ons找到最近安装的插件取消勾选「Enabled」重启后再测试。确认是哪个插件后可以在插件设置里单独关闭它的键位覆盖选项。5.4 脚本运行后工具栏消失这是bpy.ops.wm.tool_set_by_id在某些 Blender 构建版本上的副作用。按T键可以重新调出工具栏。如果仍然不显示进入Edit Preferences Interface确认「Toolbar」相关的显示选项没有被关闭。5.5 用 TaoToken 分析配置时返回结果不准确模型对 Blender 键位的理解依赖你提供的上下文。建议把完整的keymap导出内容贴进去而不是只描述现象。如果只是问「按 G 移动 cursor 怎么办」模型可能给出通用建议如果贴上具体的映射表它能精确定位到哪一行被改了。6. 长期维护与自动化建议如果你经常在不同机器之间同步 Blender 配置建议把修复脚本保存成一个.py文件放在scripts/startup目录下这样每次启动 Blender 都会自动执行一次重置。路径参考Windows:C:\Users\你的用户名\AppData\Roaming\Blender Foundation\Blender\4.x\scripts\startupmacOS:/Users/你的用户名/Library/Application Support/Blender/4.x/scripts/startupLinux:~/.config/blender/4.x/scripts/startup对于需要批量处理多个工程文件的场景可以用 TaoToken 的 API 做配置比对。把每个工程的键位导出后发给模型让它标记出与默认配置的差异再生成对应的修复脚本。这种方式比手动逐个检查快很多尤其适合团队协作时统一开发环境。如果你在接入过程中遇到 API 报错或鉴权问题优先检查 API Keys 页面里的 Key 是否过期以及请求头里的Authorization字段格式是否正确。接入文档里有完整的请求示例https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc最后提醒一点脚本修复的是配置层面的问题如果你按 G 之后物体移动方向异常比如只沿 Z 轴走那是变换朝向被设成了 Local 而不是 Global在脚本第 4 步里已经把transform_orientation重置为GLOBAL重启后应该恢复正常。如果还有残留问题把当前键位导出后贴到模型对话里让它逐行比对默认配置通常能定位到具体的覆盖项。