如何用 Python 调用有道翻译 API？2026手把手教你实现 GitHub 项目文档自动化翻译！

pip install requests hashlib uuid time  # 核心就这几个

import hashlib
import uuid
import time
import requests
import json

def youdao_translate(text, from_lang='auto', to_lang='zh-CHS'):
    APP_KEY = '你的APP_KEY'
    APP_SECRET = '你的APP_SECRET'
    YOUDAO_URL = 'https://openapi.youdao.com/api'
    
    salt = str(uuid.uuid4())
    curtime = str(int(time.time()))
    sign_str = APP_KEY + text[:20] + salt + curtime + APP_SECRET  # 截取前20字符防超长
    sign = hashlib.sha256(sign_str.encode('utf-8')).hexdigest()
    
    data = {
        'q': text,
        'from': from_lang,
        'to': to_lang,
        'appKey': APP_KEY,
        'salt': salt,
        'sign': sign,
        'signType': 'v3',
        'curtime': curtime
    }
    
    response = requests.post(YOUDAO_URL, data=data, timeout=10)
    result = response.json()
    
    if result.get('errorCode') == '0':
        return result['translation'][0]
    else:
        print(f"错误码: {result.get('errorCode')}")
        return None

# 测试
print(youdao_translate("Hello, how to automate GitHub docs translation with Python?"))

import os
from pathlib import Path

def translate_md_file(file_path, target_lang='zh-CHS'):
    with open(file_path, 'r', encoding='utf-8') as f:
        content = f.read()
    
    # 简单分段翻译（实际项目建议用正则保留代码块、标题等）
    paragraphs = content.split('\n\n')
    translated = []
    for p in paragraphs:
        if p.strip() and not p.startswith('```'):  # 跳过代码块
            trans = youdao_translate(p, to_lang=target_lang)
            translated.append(trans or p)
        else:
            translated.append(p)
    
    new_content = '\n\n'.join(translated)
    output_path = file_path.with_name(f"{file_path.stem}_{target_lang}{file_path.suffix}")
    with open(output_path, 'w', encoding='utf-8') as f:
        f.write(new_content)
    print(f"翻译完成: {output_path}")

# 使用
docs_dir = Path('docs')
for md_file in docs_dir.rglob('*.md'):
    translate_md_file(md_file)

name: Auto Translate Docs
on:
  push:
    branches: [ main ]
    paths: ['docs/**']

jobs:
  translate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - run: pip install requests
      - name: Run Translation
        env:
          APP_KEY: ${{ secrets.YOUDAO_APP_KEY }}
          APP_SECRET: ${{ secrets.YOUDAO_APP_SECRET }}
        run: python translate_docs.py
      - name: Commit changes
        uses: stefanzweifel/git-auto-commit-action@v5

import base64

def upload_document(file_path):
    # ... 类似签名逻辑
    with open(file_path, 'rb') as f:
        file_base64 = base64.b64encode(f.read()).decode()
    # POST 到 https://openapi.youdao.com/file_trans/upload
    # 然后轮询 query 接口获取结果