前言：Codex 是什么？
Codex 是 OpenAI 推出的强大 AI 代码生成模型，也是 GitHub Copilot 背后的核心技术。它可以将自然语言描述转换为可运行的代码，支持 Python、JavaScript、Go、Ruby 等数十种编程语言。
如果你还没有体验过用"说话"的方式写代码，这篇手册将带你从零开始掌握 Codex。
第一章：环境准备与访问方式
目前普通开发者主要通过以下三种方式使用 Codex 模型（注意：原版 Codex 模型已于 2023 年 3 月停止直接 API 访问，建议使用其演进版本 GPT-4 Turbo 或 GitHub Copilot）。
1.1 推荐方案：GitHub Copilot
-
安装插件：VS Code、JetBrains IDE、Neovim 等
-
订阅：个人版 10/月 或 100/年，学生/开源维护者免费
1.2 替代方案：GPT-4 API（代码能力近似）
-
在 OpenAI API 中使用
gpt-4-turbo-preview或gpt-3.5-turbo -
设置
system提示词为"You are a senior software engineer..."
1.3 开源本地替代（不依赖网络）
- StarCoder、Code Llama、DeepSeek-Coder
第二章：核心能力速览
| 功能 | 说明 |
|---|---|
| 代码生成 | 从注释或函数名生成完整代码 |
| 代码补全 | 自动补全当前行或多行逻辑 |
| 代码解释 | 输入代码段，要求用自然语言解释 |
| 代码翻译 | Python → JavaScript，Go → Rust 等 |
| 单元测试生成 | 为给定函数自动写测试用例 |
| 文档生成 | 为函数生成 docstring 或注释 |
| 错误修复 | 根据错误信息建议修正代码 |
第三章：编写高效提示词（Prompt）的黄金法则
Codex 的表现高度依赖你的描述质量。遵循以下原则：
✅ DO -- 好的做法
1. 给出明确的输入输出示例
python
# 写一个函数，输入用户列表，返回年龄大于18的用户名
# 输入: [{"name": "Alice", "age": 22}, {"name": "Bob", "age": 17}]
# 输出: ["Alice"]
def filter_adults(users):2. 定义函数签名
python
def calculate_average(numbers: list[float]) -> float:
"""返回列表的平均值，空列表返回0.0"""3. 分步引导复杂逻辑
python
# 步骤1: 读取CSV文件
# 步骤2: 过滤掉价格为负的行
# 步骤3: 按价格降序排序
# 步骤4: 输出前10行❌ DON'T -- 避免的错误
-
过于抽象："写个网站" → 应拆解为"用 Flask 写一个返回 Hello World 的路由"
-
忽略上下文：Codex 只能看到当前文件和最近的对话历史
-
使用模糊词汇："高效" → 应具体为"O(n log n)时间内"
第四章：实战场景与提示词模板
场景一：编写实用函数
text
提示：写一个 Python 函数，使用 requests 库下载一个图片，并保存到本地，文件名为 URL 的 MD5 哈希值加上 .jpg 后缀。处理可能出现的网络异常。场景二：正则表达式生成
text
提示：写一段 JavaScript 正则，匹配形如 2024-03-15 的日期，并提取年月日到捕获组。场景三：代码重构
text
提示：将以下循环改为列表推导式：
result = []
for i in range(10):
if i % 2 == 0:
result.append(i*2)场景四：编写单元测试（pytest）
text
提示：为以下函数编写 pytest 测试用例，覆盖正常值、边界值和异常输入：
def divide(a, b):
if b == 0:
raise ValueError("Cannot divide by zero")
return a / b第五章：高级技巧
5.1 使用"伪代码"进行设计
先用自然语言写清楚逻辑，再让 Codex 翻译。
text
1. 获取当前工作目录下所有 .txt 文件
2. 读取每个文件的内容
3. 统计每个文件中的单词数
4. 生成一个 CSV 报告，列名：文件名,单词数5.2 提供错误信息让它修复
将完整的错误堆栈贴到注释中。
text
以下代码执行抛出 KeyError: 'user_id'，请修正：
[你的代码]
错误信息：
Traceback...5.3 角色扮演提示
text
你是一名资深后端工程师，请用 Go 语言编写一个 HTTP 中间件，用于记录每个请求的耗时，格式为 JSON 日志输出。第六章：安全与注意事项
| 风险 | 应对措施 |
|---|---|
| 生成不安全代码（SQL注入、eval使用） | 始终人工审查；开启代码扫描工具 |
| 泄露敏感信息 | 不要将 API Key、密码等放入提示词 |
| 依赖过时或虚假的库 | Codex 可能幻想出不存在的方法名，请查官方文档 |
| 版权问题 | 避免直接复制生成的代码用于商业闭源产品（尤其 Copilot 曾引发诉讼） |
⚠️ 重要 ：Codex 不是正式工程师。它的输出可能出现逻辑错误、性能陷阱或安全漏洞，务必测试后再合并。
第七章：常见问题排查
Q：为什么 Codex 不生成任何内容？
A：检查注释是否以 # 开头且紧跟函数定义；尝试更具体的描述；或者先用一句话"写一段代码实现..."。
Q：如何让补全更长？
A：在 Copilot 中连续按 Ctrl+Enter 打开独立面板；在 API 中提高 max_tokens 参数。
Q：生成的代码风格不一致？
A：在你的项目中配置 .editorconfig 或 prettier，并确保提示词中包含示例代码的风格。
结语：人机协作的新边界
Codex 不会取代程序员，但使用 Codex 的程序员可能取代不使用它的程序员。它像一个反应极快、知识面广但缺乏判断力的初级结对程序员。
掌握提示词工程，保持代码审查习惯，你会发现自己写代码的速度提升 2-3 倍，同时把更多精力花在架构设计、代码质量和团队协作上。
现在，打开你的编辑器，写下一行注释试试看吧。