无需连接Google API，如何用gspread创建模拟表格做单元测试？

可以实现，你可以通过以下两种方式隔离Google Sheets连接，专注测试核心业务逻辑：

1. 直接Mock初始化时的元数据获取逻辑 #

因为Spreadsheet和Worksheet初始化时会自动调用fetch_sheet_metadata这类网络请求方法，你可以用Python的unittest.mock直接mock掉这些方法，跳过真实请求：

from unittest.mock import Mock, patch
import gspread

def test_worksheet_title_handling():
    # 构造一个模拟的客户端对象（不需要真实权限）
    mock_client = Mock(spec=gspread.Client)

    # Mock掉Spreadsheet的元数据获取方法，避免网络请求
    with patch.object(gspread.Spreadsheet, 'fetch_sheet_metadata'):
        # 初始化Spreadsheet，传入模拟的ID和客户端
        spreadsheet = gspread.Spreadsheet(mock_client, {'id': 'test-spread-id'})

        # 直接构造Worksheet对象，传入模拟的属性
        worksheet = gspread.Worksheet(
            spreadsheet,
            {'properties': {'title': 'Sales Data', 'sheetId': 67890}}
        )

        # 测试你的核心逻辑，比如自定义的标题格式化函数
        def format_sheet_title(ws):
            return f"[Sheet] {ws.title}"
        
        assert format_sheet_title(worksheet) == "[Sheet] Sales Data"

这种方式完全跳过了任何网络交互，适合测试不依赖gspread API响应的纯逻辑代码。

2. 配合Dummy Client + Mock请求响应 #

你之前尝试的DUMMY_ACCESS_TOKEN可行，但需要同时mock客户端的request方法，返回模拟的API响应：

from unittest.mock import patch
from gspread.client import Client
from gspread.auth import DUMMY_ACCESS_TOKEN

def test_spreadsheet_sheet_list():
    # 创建Dummy客户端
    dummy_client = Client(DUMMY_ACCESS_TOKEN)

    # Mock客户端的request方法，返回模拟的Spreadsheet元数据
    with patch.object(dummy_client, 'request') as mock_request:
        mock_request.return_value = {
            'properties': {'title': 'Test Spreadsheet'},
            'sheets': [
                {'properties': {'title': 'Sheet1', 'sheetId': 1}},
                {'properties': {'title': 'Sheet2', 'sheetId': 2}}
            ]
        }

        # 正常调用open_by_key，此时会使用mock的响应
        spreadsheet = dummy_client.open_by_key('dummy-spread-id')
        sheet_titles = [sheet.title for sheet in spreadsheet.worksheets()]

        # 测试你的逻辑，比如校验工作表数量
        assert len(sheet_titles) == 2
        assert 'Sheet1' in sheet_titles

这种方式更接近真实的使用流程，但所有API响应都是模拟的，不会触发真实的Google Sheets请求。

核心原则是：把所有涉及网络IO的gspread内置方法都mock掉，只测试你自己编写的业务逻辑（比如数据转换、单元格操作逻辑等），gspread本身的API调用正确性可以留到后续集成测试中验证。

内容的提问来源于stack exchange，提问作者RafaelFerreira