# 外部与内部成员测试策略指南本技巧帮助您在.NET测试中正确处理真空与内部成员的测试，强调设计优先的测试思维。 ## 适用于当被要求执行以下任务时，请使用此技能： * 测试私有或内部方法与属性 * 设置InternalsVisibleTo 访问内部成员 * 评估是否需要测试方法或应重构设计 * 使用引用（Reflection）访问端点成员 * 提升计划代码的可测试性设计 ## 核心原则：设计优先思维 ###黄金法则 **好的设计自然有好的可测试性。如果你发现自己需要经常测试种植方法，很可能是设计生长的问题。** ### 设计问题的征兆当您想测试启动方法时，请先检查以下征兆： * ❌ 一种方法超过10行且包含复杂逻辑 * ❌原生方法包含重要的业务规则 * ❌ 容器方法难以公开方法间接测试 * ❌类别承担多种职责 ### 解决方案：重构测试天线 // ❌ 设计存在问题公共类订单处理器 { public OrderResult ProcessOrder(订单顺序) { // 使用多种复杂的方法 var折扣=计算折扣（订单）； // 20行逻辑 var 税=CalculateTax(订单，折扣); // 15行逻辑 // ... } private十进制CalculateDiscount(Order order) { /* 复杂逻辑 */ } privatedecalCalculateTax(Order order,decimaldiscount) { /* 复杂逻辑 */ } } // ✅ 改进的设计：责任分离公共类订单处理器 { 私有只读 IDiscountCalculator _discountCalculator；私有只读 ItaxCalculator _taxCalculator; 公共订单处理器（ IDiscountCalculator折扣计算器， ITaxCalculator 税计算器） { _discountCalculator = 折扣计算器； _taxCalculator = 税计算器； } public OrderResult ProcessOrder(订单顺序) { var 折扣 = _discountCalculator.Calculate(order); vartax = _taxCalculator.Calculate(订单，折扣); // ... } } // 现在可以独立测试每个外汇公共类折扣计算器：IDiscountCalculator { 公共小数计算(订单顺序) { // 复杂逻辑现在是公开方法，易于测试 } } ## 内部成员测试策略 ### 何时需要测试内部成员 **适合的姿势：** * ✅ 框架或类别库开发 * 复杂的内部演算法验证 * ✅ 完成关键的内部组件 * ✅ 安全相关的内部逻辑 **不适合的姿势：** * ❌应用层的业务逻辑（应该是public） * ❌简单的辅助方法 * ❌可以公开API间接测试的逻辑 ### 方法一：使用InternalsVisibleTo属性最直接的方法，适合简单的情况： // 在主专案中的AssemblyInfo.cs或任何类别文件中使用 System.Runtime.CompilerServices； [程序集：InternalsVisibleTo("YourProject.Tests")] [程序集：InternalsVisibleTo("YourProject.IntegrationTests")] **优点：** * 简单直接 * 需要额外套件 **缺点：** * 需要硬编码组件名称 * 指定组件时需要包含全局 ###方法二：在csproj中设置通过MSBuild属性设置： <项目Sdk =“Microsoft.NET.Sdk”> <属性组> net9.0 <项目组> <_Parameter1>$(程序集名称).测试 **优点：** * 可以使用MSBuild变量 * 集中管理 ### 方法三：使用Meziantou.MSBuild.InternalsVisibleTo（推荐）对于复杂的专案，推荐使用这个NuGet套件： <项目组> <私有资产>全部运行时；建造;本国的;内容文件；分析器 <项目组> **优点：** * 处理自动签署组件的主角 * 支持DynamicProxyGenAssembly2（NSubstitute/Moq） * 强迫性高 **参考资源：** * [在 csproj 中声明 InternalsVisibleTo - Meziantou 的博客]() * [GitHub - meziantou/Meziantou.MSBuild.InternalsVisibleTo]() ### 内部测试的风险评估评估方向 | 风险程度 | 说明 ---|---|--- 封装性破坏地中海 | 增加了对内部实作的依赖的测试重构阻力高| 改变内部成员会影响测试维护成本 | 地中海 | 需要同步维护生产代码和测试代码设计品质 | 低| 如果过度使用，可能表示设计有问题 ## 创业方法测试技术内容涵盖决策树（是否应测试封装方法）、反射测试封装方法与静态方法、`ReflectionTestHelper`辅助类别封装，以及反射测试的风险与最佳实践。 > 📖 完整程序示例与技术细节请参考 [references/private-method-testing.md]() ## 测试友善的设计模式 ### 策略模式改善可测试性将复杂的逻辑重构策略为模式： ####重构前：难以测试的设计公开课定价服务 { 公共小数计算价格（产品产品，客户客户） { var basePrice = 产品.BasePrice; var折扣=计算折扣（客户，产品）； // 方法 vartax =CalculateTax(产品, 客户.Location); // 方法返回basePrice - 折扣+税； } 私人小数CalculateDiscount（客户客户，产品产品） { // 20行复杂的冗余计算逻辑 } 私有十进制CalculateTax（产品产品，位置位置） { // 15行复杂度的计算 } } ####重构后：策略使用模式 // 策略面公共接口 IDiscountStrategy { 小数计算（客户客户，产品产品）； } 公共接口 ItaxStrategy { 小数计算（产品产品，位置位置）； } // 具体策略实作公共类 StandardDiscountStrategy ： IDiscountStrategy { 公共小数计算（客户客户，产品产品） { // 照明逻辑现在是公开方法，易于测试 if (客户.IsVIP) 返回产品.BasePrice * 0.1m; 返回0； } } 公开课台湾税务策略：ITaxStrategy { 公共小数计算（产品产品，位置位置） { // 电阻逻辑现在是公开方法，易于测试返回产品.BasePrice * 0.05m; } } // 改进的服务公开课定价服务 { 私有只读 IDiscountStrategy _discountStrategy；私有只读 ItaxStrategy _taxStrategy；公共定价服务（ IDiscountStrategy 折扣策略， ITaxStrategy (税收策略) { _discountStrategy = 折扣策略； _taxStrategy = 税收策略； } 公共小数计算价格（产品产品，客户客户） { var basePrice = 产品.BasePrice; vardiscount = _discountStrategy.Calculate(客户，产品); vartax = _taxStrategy.Calculate(产品, customer.Location); 返回basePrice - 折扣+税； } } **优点：** * 每个都可以策略独立测试 * 符合开放封闭原则 * 易于扩展新的策略 * 减少对依赖的依赖 ### 部分模拟（Partial Mock）有時需要模擬類別的部分行為： // 需要部分模擬的類別 public class DataProcessor { public ProcessResult Process(string input) { var validated = ValidateInput(input); if (!validated) return ProcessResult.InvalidInput(); var data = TransformData(input); var saved = SaveData(data); // 想模擬這個方法避免實際資料庫操作 return saved ? ProcessResult.Success() : ProcessResult.Failed(); } protected virtual bool SaveData(string data) { // 實際的資料庫操作 return true; } private bool ValidateInput(string input) => !string.IsNullOrEmpty(input); private string TransformData(string input) => input.ToUpper(); } // 測試用的子類別 public class TestableDataProcessor : DataProcessor { protected override bool SaveData(string data) { // 模擬實作，避免實際資料庫操作 return true; } } // 測試 [Fact] public void Process_使用部分模擬_應成功處理() { // Arrange var processor = new TestableDataProcessor(); // Act var result = processor.Process("test"); // Assert result.Success.Should().BeTrue(); } ## 實務決策框架 ### 三層次風險評估法 #### 第一層：設計品質評估 **問題：這是設計問題還是測試問題？** * 私有方法是否過於複雜？（> 10 行） * 類別是否承擔多個職責？ * 是否可以提取為獨立類別？ **建議行動：** * 優先考慮重構（提取類別、策略模式） * 透過改善設計來改善可測試性 #### 第二層：維護成本評估 **問題：測試是否會成為重構的阻礙？** * 測試是否依賴實作細節？ * 重構時測試是否需要大量修改？ * 測試失敗時是否難以定位問題？ **建議行動：** * 如果維護成本高，重新考慮測試策略 * 考慮透過公開 API 的整合測試 #### 第三層：價值產出評估 **問題：測試帶來的價值是否超過成本？** 評估測試價值： * ✅ 能抓到真實的業務邏輯錯誤 * ✅ 提供清楚的失敗訊息 * ✅ 在合理成本下長期穩定運行 **建議行動：** * 如果價值不足，尋找替代測試策略 * 考慮效能測試、整合測試等其他方式 ### 決策矩陣情境 | 建議做法 | 理由 ---|---|--- 簡單私有方法（< 10 行） | 透過公開方法測試 | 維護成本低複雜私有邏輯（> 10 行） | 重構為獨立類別 | 改善設計與可測試性框架內部演算法 | 使用 InternalsVisibleTo | 需要精確測試內部行為遺留系統私有方法 | 考慮使用反射測試 | 短期內難以重構安全相關私有邏輯 | 重構或使用反射測試 | 需要獨立驗證正確性頻繁變動的實作細節 | 避免直接測試 | 測試會變得脆弱 ## DO - 建議做法 1. **設計優先** * ✅ 優先考慮重構而非測試私有方法 * ✅ 使用依賴注入和介面抽象 * ✅ 應用策略模式分離複雜邏輯 * ✅ 保持單一職責原則 2. **測試公開行為** * ✅ 專注測試公開 API 的行為 * ✅ 透過公開方法間接測試私有邏輯 * ✅ 使用整合測試覆蓋複雜流程 3. **明智使用 InternalsVisibleTo** * ✅ 僅用於框架或類別庫開發 * ✅ 使用 Meziantou.MSBuild.InternalsVisibleTo 簡化設定 * ✅ 記錄為何需要開放 internal 可見性 4. **謹慎使用反射** * ✅ 建立輔助方法封裝反射邏輯 * ✅ 在測試名稱中標示使用反射 * ✅ 定期檢視是否可以重構 ## DON'T - 避免做法 1. **不要過度測試私有方法** * ❌ 避免為每個私有方法寫測試 * ❌ 不要測試簡單的 getter/setter * ❌ 避免測試純粹的委派呼叫 2. **不要忽略設計問題** * ❌ 不要把測試當作設計問題的替代方案 * ❌ 避免因為測試而破壞封裝 * ❌ 不要讓測試阻礙重構 3. **不要依賴實作細節** * ❌ 避免測試私有方法的呼叫順序 * ❌ 不要驗證私有欄位的值 * ❌ 避免測試頻繁變動的實作細節 4. **不要濫用 InternalsVisibleTo** * ❌ 不要為應用層程式碼開放 internal * ❌ 避免過多的測試專案可見性 * ❌ 不要用它取代適當的公開 API ## 範例參考參考 `templates/` 目錄下的完整範例： * `internals-visible-to-examples.cs` \- InternalsVisibleTo 設定範例 * `reflection-testing-examples.cs` \- 反射測試技術範例 * `strategy-pattern-refactoring.cs` \- 策略模式重構範例 ## 參考資源 ### 原始文章本技能內容提煉自「老派軟體工程師的測試修練 - 30 天挑戰」系列文章： * **Day 09 - 測試私有與內部成員：Private 與 Internal 的測試策略** * 鐵人賽文章： * 範例程式碼： ### 官方文件 * [Meziantou's Blog - InternalsVisibleTo]() ### 相關技能 * `unit-test-fundamentals` \- 單元測試基礎 * `nsubstitute-mocking` \- 測試替身與模擬 ## 測試清單在處理私有與內部成員測試時，確認以下檢查項目： * 已評估是否應該重構而非測試私有方法 * Internal 成員確實需要開放給測試專案 * 使用適當的 InternalsVisibleTo 設定方法 * 反射測試已使用輔助方法封裝 * 測試名稱清楚標示測試類型（如使用反射） * 策略模式等設計模式已考慮用於複雜邏輯 * 測試不會成為重構的阻礙 * 測試提供的價值超過維護成本 * 沒有過度依賴實作細節 * 定期檢視測試策略的適切性

Dotnet 测试私人内部测试

包含技能