多系统安装指南：Windows与macOS差异化配置详解
在Windows与macOS上部署Qoder时，因路径、权限或依赖问题导致安装失败，是跨平台开发环境的典型挑战。这源于操作系统在软件签名、包管理、沙盒策略及Shell环境等核心机制上的根本性差异。以下将详细解析两个平台的具体安装流程与关键配置。
一、Windows平台安装与配置要点
Windows安装以图形化向导为主，但其底层依赖PowerShell运行时与注册表配置。安装成功的核心在于处理防火墙规则、获取管理员权限，以确保CLI命令全局可用及IDE后台服务稳定运行。
首先，访问官方下载页面，获取“Windows x64”版本的安装包（通常命名为Setup-x64.exe）。
运行安装程序时，在向导界面必须勾选“添加至系统PATH”与“开机自启服务”选项。这是避免后续在终端中无法调用qoder命令的关键步骤。
安装完成后，请以管理员身份启动PowerShell，执行qoder --version命令验证安装。若系统提示“未识别命令”，通常需要重启终端，或手动将Qoder安装目录下的bin子目录添加至系统环境变量。
首次启动Qoder IDE时，Windows Defender防火墙可能会弹出拦截提示。务必在防火墙设置中允许Qoder.exe通过专用和公用网络，否则IDE将无法连接云端模型服务。
二、macOS平台安装与配置要点
macOS的安全机制更为严格，Gatekeeper签名验证与App Sandbox隔离策略是主要障碍。Qoder.app常被标记为“来自未识别开发者”，且系统对Homebrew等包管理器依赖性强。安装核心在于解除系统隔离并完成开发者授权。
第一步是准备基础环境。打开终端，执行brew install python node git命令安装必要依赖。若尚未安装Homebrew，需先运行其官方安装脚本。
从官网下载.dmg镜像文件，双击挂载后，将Qoder.app拖拽至“应用程序”文件夹。此时系统通常会弹出“无法验证开发者”警告。
不要点击“取消”。前往“系统设置→隐私与安全性”，在“安全性”区域找到相关提示，点击“仍要打开”完成首次授权。
为确保所有插件（尤其是内核级插件与本地Agent模块）正常加载，还需在终端执行命令以彻底移除应用的隔离属性：sudo xattr -rd com.apple.quarantine /Applications/Qoder.app。
三、双平台共性配置差异处理
尽管Qoder在Windows和macOS上使用相同的配置文件结构（config.yaml），但两套系统在路径解析、编码格式与权限继承上的差异，可能导致直接复制的配置失效。Windows使用反斜杠路径和CRLF换行符，而macOS强制使用UTF-8编码和LF换行符，对家目录(~)符号的展开逻辑也不同。
在Windows上，配置文件通常位于%APPDATA%\Qoder\config.yaml。编辑时，请使用VS Code等支持UTF-8无BOM编码的编辑器，并注意禁用其自动转换换行符的功能。
在macOS上，配置文件路径为~/Library/Application Support/Qoder/config.yaml。若通过scp或iCloud同步此文件，保存前需手动将换行符统一为LF格式，并仔细检查所有路径，确保其中不包含任何Windows风格的盘符（如C:）或反斜杠（\）。
对于SSH密钥、Git凭据等敏感文件的路径配置（如git_ssh_key_path字段），差异更为显著：Windows需填写C:\Users\Name\.ssh\id_rsa格式的绝对路径；而macOS必须使用/Users/Name/.ssh/id_rsa格式。在macOS下，别忘了通过chmod 600命令确保密钥文件权限为600。
四、界面与语言初始化差异应对
Qoder IDE首次启动时读取系统语言的方式在两大平台上不同。Windows优先匹配控制面板的“语言与区域”设置，而macOS严格遵循系统偏好设置中的语言顺序与NSLocale配置。这导致了中文界面触发时机与切换稳定性的差异。
Windows用户若安装后界面仍为英文，请检查安装向导最后一步是否勾选了“默认使用中文界面”。若未勾选，需手动编辑config.yaml文件，将language字段值设为zh-CN，然后重启IDE。
macOS用户首次启动后若未出现语言切换弹窗，可通过终端命令强制设置：执行defaults write com.qoder.Qoder IDE AppLanguage zh-Hans，然后完全退出并重新启动Qoder应用。
此外，两个平台的字体渲染引擎不同（Windows用ClearType，macOS用subpixel antialiasing）。若在代码编辑区发现字符显示模糊，可尝试在Qoder设置中关闭“硬件加速渲染”选项，然后重启IDE。