百度Comate的安装与配置流程，归纳起来仅需三个步骤：从官网下载正版安装包，在VS Code或JetBrains中部署官方插件并重启，最后登录百度账号激活功能。然而许多开发者恰恰在看似简单的前期准备环节遇到阻碍——版本选错、账号未登录、插件未生效，导致无法生成一行有效代码。此类问题虽普遍，但只需按照正确步骤操作即可快速解决。

确认安装渠道的官方来源

启动浏览器，直接访问百度官方唯一认证的下载主页【https://comate.baidu.com】。任何带有“Comate”字样的第三方站点均不可轻信——其安装包可能暗藏未知风险。

该页面会根据您的操作系统自动适配：Windows用户点“立即下载(Windows)”，macOS用户点“立即下载(macOS)”。下载包体积约180MB，全程无广告、无捆绑，纯净安装。

若从应用商店或第三方平台下载，极可能获取的是旧版、阉割版，甚至包含恶意插件的仿冒包。【安装后可能无法登录、补全失效、甚至泄露本地代码】——这并非危言耸听，已有不少开发者因此受损。

VS Code插件安装（新手推荐首选）

打开VS Code，点击左侧扩展图标或按Ctrl+Shift+X，在顶部搜索栏输入“Baidu Comate”。结果列表中仅选择开发者“Baidu”、带有“官方”标识的插件，点击“安装”。

安装完成后务必重启VS Code，否则状态栏右下角不会显示Comate图标。若首次启动未自动弹出登录窗口，可手动点击左侧Comate图标，再点击“登录”按钮，即可唤起百度账号授权页面。

需要特别强调：【未登录状态下所有代码生成功能将被禁用】。即使插件已安装、图标亮起，未登录则无法使用。

快速生成第一段代码

方法一：通过自然语言指令生成
在任意代码文件中新建一行，输入中文注释，例如：
// 实现一个函数，接收字符串列表，返回去重后的列表
将光标置于该行末尾，按下Enter键，Comate将自动生成对应的Python代码块；按Tab采纳，按Esc取消。

方法二：基于选中代码进行补全
编写函数定义如def sort_nums(nums):，回车后Comate将根据上下文自动补全缩进、循环或排序逻辑，无需额外触发，省时省力。

方法三：通过右键菜单调用
选中一段函数代码，右键选择“生成注释”或“生成单元测试”，Comate会在侧边栏输出内容，点击“采纳”即可插入到当前文件或新建测试文件中。

JetBrains系列IDE安装（PyCharm/IntelliJ IDEA等）

第一步：启动IDE，点击顶部File → Settings（macOS为IDEA → Preferences）。
第二步：进入Plugins，切换至Marketplace，搜索Comate，找到Baidu官方插件，点击Install。
第三步：安装完成后重启IDE，右下角弹出登录提示，点击登录，输入百度账号，完成授权。

若插件市场加载缓慢或无法搜索到，可前往官网下载离线安装包（.zip），然后通过Plugins界面右上角齿轮图标 → “Install from Disk…”手动导入安装。该备用方案在网络不佳时尤为实用。