代码转换功能可在保留业务逻辑完全等价的前提下，将现有代码从一种编程语言、框架语法快速转换为另一种，无需逐行手动重写，大幅降低跨技术栈迁移、旧框架升级、多端功能复刻的工作量。支持绝大多数主流编程语言与前端框架，是跨栈开发、旧项目改造的高频实用功能。
一、三种触发方式，按需选用
1. 侧边栏指令转换（推荐，灵活度最高）
适合绝大多数转换场景，可自由指定目标语言、框架版本、编码规范，自定义程度最高：
- 在编辑器中选中需要转换的完整代码片段；
- 打开 Codex 侧边栏，输入转换指令，明确说明目标语言/框架；
- 发送后等待生成结果，不满意可继续补充要求迭代调整。
2. 右键快捷转换（单段代码快速处理）
适合短代码片段的快速转换，操作更便捷：
- 选中目标代码，点击鼠标右键；
- 选择「Codex → Convert language（转换语言）」，在弹出的输入框中填写目标语言（如“Python”“React”）；
- 确认后自动在侧边栏生成转换后的代码。
3. 网页端批量转换（整文件/多文件迁移）
适合整文件、整个仓库的批量转换场景，本地插件处理大文件容易卡顿：
- 登录 Codex 网页端，绑定目标代码仓库；
- 输入批量转换指令，指定转换范围和目标技术栈；
- 提交后云端后台运行，完成后可直接生成 PR 或下载转换后的文件。
二、常用场景与指令模板（直接套用）
针对不同转换类型，使用对应指令可大幅提升结果准确率，避免直译导致的代码冗余。
1. 编程语言互转
用于不同后端语言、脚本语言的逻辑迁移，核心是保证输入输出完全一致。
指令模板：将这段 Java 代码转换成等价的 Go 语言代码，使用 Go 标准库实现，不引入第三方依赖，保留所有原有业务逻辑和异常处理，变量命名符合 Go 语言命名规范。
2. 前端框架互转
用于组件跨框架复用、旧项目技术栈升级，是前端开发最高频的转换场景。
指令模板：将这段 Vue2 选项式 API 组件转换成 Vue3 组合式 API 写法，使用
<script setup>语法，样式和交互逻辑完全不变，替换对应的生命周期和 API 写法。
3. 语法版本升级
用于旧语法规范升级到现代标准，比如 ES5 转 ES6+、Python2 转 Python3。
指令模板：将这段 ES5 代码升级为 ES6+ 现代语法，使用箭头函数、解构赋值、模板字符串等特性，简化冗余写法，功能完全保持一致。
4. 数据库/配置语法转换
用于 SQL 方言、配置文件的跨平台迁移。
指令模板：将这段 MySQL 建表语句转换成 PostgreSQL 语法，对应调整字段类型和索引写法，保留所有字段约束和默认值。
三、提升转换准确率的实用技巧
- 明确指定版本与规范
不要只说“转成 React”，要说明具体版本和写法，比如“转成 React 18 函数组件 + Hooks 写法 + TypeScript”，避免生成旧版本语法。
- 提前说明特殊业务规则
如果代码包含特殊边界处理、兼容逻辑、业务约定，提前在指令中备注，比如“注意空值处理逻辑要完全保留，不能修改判断条件”，避免转换后隐性逻辑变更。
- 小片段分批转换，逐段核对
不要一次性选中整文件所有代码，按函数、按组件、按模块分批转换，每转换一段就核对功能，出现问题容易定位修正。
- 指定依赖库与实现方式
涉及第三方能力时，明确指定使用的库，比如“网络请求统一使用 axios 实现”“工具函数用 Lodash”，避免自动生成的依赖不符合项目规范。
四、常见问题与处理
- 转换后语法报错、无法运行
补充目标环境的具体信息重新生成，比如“目标运行环境是 Node.js 18 LTS，使用 CommonJS 模块规范”，明确版本后语法兼容性会大幅提升。
- 直译导致代码冗余，不符合目标语言最佳实践
补充优化要求：“不要逐行直译，使用目标语言的原生特性和最佳实践重构，保证逻辑等价的前提下代码简洁规范”。
- 转换后业务逻辑和原代码有差异
明确约束规则重新生成：“严格保留原代码的所有输入输出规则、边界判断和异常处理逻辑，仅转换语法实现，不改动任何业务逻辑”，可附上测试用例辅助对齐。
- 部分原生 API 没有直接对应实现
针对具体 API 追问：“原代码中的 XX 方法在目标语言中没有原生等价，给出三种常用的替代实现方案，说明各自的适用场景”。
实用提醒：转换完成后务必运行原有测试用例验证功能一致性，不同语言的类型系统、浮点数精度、内置方法特性存在差异，核心业务代码不可直接未经测试就上线使用。