ChatGPT编程实战：从需求分析到代码生成的最佳实践

1次阅读

共计 2099 个字符，预计需要花费 6 分钟才能阅读完成。

使用 ChatGPT 辅助编程时，开发者常遇到以下问题：

需求理解偏差：AI 可能误解模糊的需求描述，例如将 ” 用户登录 ” 理解为仅前端验证而忽略后端鉴权
冗余代码：生成包含未使用的函数参数或过时的 API 调用（如 Python 的urllib2）
安全漏洞：自动生成的 SQL 查询可能包含拼接字符串导致注入风险
幻觉代码 ：引用不存在的库（如虚构的pyencrypt3 模块）或错误语法

将复杂需求分解为原子任务，使用如下结构构造提示词：

[角色] 你是一个资深 {语言} 开发者
[背景] 需要实现 {具体功能} 用于{使用场景}
[要求]
- 输入 / 输出数据类型：{明确格式}
- 性能约束：{如 O(n)复杂度}
- 安全要求：{如防止 XSS}
[示例]
输入示例：{具体样例}
期望输出：{对应结果}

# 类型注解 + 防御性编程
from typing import Optional, Dict
import requests

class APIClient:
    """
    AI 生成代码改进版：1. 增加连接超时和重试机制
    2. 添加类型注解
    3. 包含异常处理链
    """
    def __init__(self, base_url: str, timeout: int = 5):
        self.base_url = base_url.rstrip('/')
        self.timeout = timeout

    def get_data(self, endpoint: str) -> Optional[Dict]:
        """:raises: ValueError 当 endpoint 包含非法字符时"""
        if not endpoint.startswith('/'):
            endpoint = f'/{endpoint}'

        # 路径安全检查
        if '..' in endpoint:
            raise ValueError('Invalid endpoint path')

        try:
            resp = requests.get(f"{self.base_url}{endpoint}",
                timeout=self.timeout
            )
            resp.raise_for_status()
            return resp.json()
        except requests.exceptions.RequestException as e:
            print(f"API 请求失败: {e}")
            return None

/**
 * AI 生成改进版：* 1. 添加输入类型检查
 * 2. 包含单元测试用例
 */
function validateUserForm({username, password}) {if (typeof username !== 'string' || typeof password !== 'string') {throw new TypeError('参数必须为字符串');
  }

  // 防御正则表达式拒绝服务 (ReDoS) 攻击
  const SAFE_USERNAME_REGEX = /^[a-z0-9_]{4,20}$/i;

  return {isValid: SAFE_USERNAME_REGEX.test(username) && password.length >= 8,
    errors: {username: !SAFE_USERNAME_REGEX.test(username) 
        ? '仅允许字母数字和下划线(4-20 位)' : null,
      password: password.length < 8 
        ? '密码至少 8 位' : null
    }
  };
}

// 单元测试示例
console.assert(validateUserForm({ username: 'test_123', password: 'qwertyui'}).isValid,
  '合法输入测试失败'
);

SQL 注入检测：检查是否使用参数化查询
危险代码：f"SELECT * FROM users WHERE id = {user_input}"
安全代码："SELECT * FROM users WHERE id = %s", (user_input,)
敏感信息泄露：避免硬编码 API 密钥

边界测试：用空数组、极大数字等极端值测试
突变测试：随机删除代码块验证测试覆盖率
人工复核：重点检查权限控制、加密算法等关键路径

# pytest 测试用例示例
def test_api_client_timeout():
    """验证超时处理逻辑"""
    client = APIClient("http://test.com", timeout=0.001)
    assert client.get_data("/delay") is None