应通过系统设置单独配置外接键盘修饰键：在“系统设置→键盘→修饰键”中选择外接键盘，将option键设为command、command键设为option；或用karabiner-elements、hidutil命令、键盘固件切换等方法实现设备级精准映射。
如果您使用外接 Windows 布局键盘连接 Mac，会发现物理 Win 键触发 macOS 的 Option（⌥）行为、而 Alt 键却执行 Command（⌘）快捷键，导致 VS Code 中 cmd+p 需改按 alt+p、Safari 中 cmd+t 新建标签页失效 等操作错乱，则很可能是系统未针对该外接设备单独配置修饰键映射。以下是解决此问题的多种可行方法：
一、通过系统设置单独配置外接键盘修饰键
macOS 原生支持为每台已连接的外接键盘独立设定修饰键行为，无需安装额外软件，且完全不影响内置键盘的默认逻辑，是最稳妥的基础方案。该方法直接在系统级将 Win 键（被识别为“Command 键”）与 Alt 键（被识别为“Option 键”）的功能输出互换，适配 Windows 键盘物理布局。
1、点击屏幕左上角的苹果菜单，选择“系统设置”。
2、在左侧边栏中滚动并点击“键盘”。
3、在右侧区域查找并点击“键盘快捷键”，再点击左侧导航栏中的“修饰键…”（部分版本直接显示为“修饰键…”按钮）。
4、在弹出窗口顶部的设备列表中，务必选择您的外接键盘名称（如“Logitech K380”“Ducky One 3”“USB Keyboard”或具体型号），切勿选中“内建键盘”或“Apple Internal Keyboard”。
5、在“Option键”下拉菜单中选择“Command”，在“Command键”下拉菜单中选择“Option”。
6、点击“好”保存设置，更改即时生效，无需重启、注销或重新插拔键盘。
二、使用 Karabiner-Elements 进行设备级精准重映射
Karabiner-Elements 是开源、轻量、支持复杂规则的 macOS 键位自定义工具，可实现单键替换、组合键拦截及多设备独立配置，适用于系统设置无法覆盖的场景（例如外接键盘被识别为“Unknown Device”、Win 键被归类为“Launcher”而非标准修饰键、或需同时交换左右两侧按键）。
1、访问官网 karabiner-elements.pqrs.org 下载并安装最新版 Karabiner-Elements。
2、首次启动后，前往“系统设置 → 隐私与安全性 → 辅助功能”，勾选 Karabiner-Elements 以授予必要权限；再进入“输入监控”设置，同样启用该应用。
3、打开 Karabiner-Elements 主界面，切换至“Devices”标签页，确认外接键盘已识别并处于启用状态（右侧开关为绿色）。
4、切换至“Simple Modifications”标签页，点击右下角“Add item”。
5、在“From key”中选择 left_command，在“To key”中选择 left_option。
6、再次点击“Add item”，设置“From key”为 left_option，“To key”为 left_command。
7、关闭窗口，映射即时生效，且该配置仅作用于所选外接键盘，内置键盘保持原始逻辑不变。
三、通过终端 hidutil 命令进行底层键码重映射
hidutil 是 macOS 内置命令行工具，可在系统级直接修改 HID 设备的键码映射，不依赖图形界面或第三方 GUI 应用，适合高级用户对特定设备实施一次性、持久化重映射。该方法绕过系统修饰键设置层，直接作用于 USB/蓝牙 HID 协议层面，对被错误识别为非标准键盘的设备尤为有效。
1、将外接键盘接入 Mac 后，在终端中运行：ioreg -p IOUSB -l | grep -E '(Product|Vendor|LocationID)'，定位设备标识信息。
2、运行 ioreg -r -k 'VendorID' | grep -A 3 -B 3 'your_keyboard_name' 获取 VendorID 和 ProductID（例如 VendorID: 0x46d，ProductID: 0xb31b）。
3、创建映射 JSON 文件：执行 echo '{"UserKeyMapping":[{"HIDKeyboardModifierMappingSrc":0x7000000e7,"HIDKeyboardModifierMappingDst":0x7000000e3},{"HIDKeyboardModifierMappingSrc":0x7000000e3,"HIDKeyboardModifierMappingDst":0x7000000e7}]}' > ~/swap-win-alt.json（其中 e7=left_command，e3=left_option）。
4、加载映射：运行 hidutil property --set $(cat ~/swap-win-alt.json)。
5、验证生效：按下 Win 键应触发 Command 行为，按下 Alt 键应触发 Option 行为。
6、如需开机自动加载，将上述命令写入 shell 配置文件或创建 LaunchAgent plist。
四、检查并修正输入源布局干扰
部分外接键盘（尤其是多系统兼容机械键盘）在连接 macOS 时可能因输入源设置为非美式英文布局（如“ABC – Extended”“ISO”或“Unicode Hex Input”）而导致物理按键与修饰键语义错位。该问题不改变键码本身，但会干扰修饰键组合逻辑，必须优先排除。
1、点击屏幕右上角输入法图标（显示为“中”“英”或国旗符号）。
2、在下拉菜单中确认当前激活的输入源是否为 美国英语（ABC）。
3、若显示其他名称（如“简体中文-拼音”“French-AZERTY”“ABC – Extended”），直接点击“美国英语”切换。
4、若列表中无“美国英语”，点击“打开键盘偏好设置”，进入“输入源”标签页，勾选“美国”，并移除所有非必要输入法。
5、断开并重新连接外接键盘，观察 Win/Alt 键行为是否恢复正常。
五、恢复外接键盘默认修饰键设置
若误操作导致外接键盘全部快捷键异常、或需快速还原出厂状态以重新调试，可一键清除该设备的自定义修饰键映射，且不影响其他已配键盘或内置键盘设置。该操作不可逆，执行前请确认当前配置已无保留价值。
1、进入“系统设置 → 键盘 → 键盘快捷键 → 修饰键…”。
2、在设备列表中准确选择您的外接键盘名称（名称旁通常带 USB 图标或厂商标识）。
3、查找窗口左下角或右下角的 “恢复默认” 按钮（文字可能为“还原”或“Reset”）。
4、点击该按钮，系统将自动将所有修饰键映射恢复为 macOS 标准布局。
