VB.NET 方法參數預設為 ByVal(值傳遞),也可顯式指定 ByRef(參考傳遞)。兩者在值類型與引用類型上的行為差異,是 Bug 高發區。本文通過記憶體模型圖解、代碼實驗、最佳實踐,徹底釐清差異。
核心結論速查
| 參數類型 | 傳遞方式 | 方法內修改參數本身 | 方法內修改參數成員/內容 | 外部可見性 |
| 值類型 | ByVal | ❌ 不影響外部 | N/A (無成員) | 外部變量不變 |
| ByRef | ✅ 影響外部 | N/A | 外部變量被修改 |
| 引用類型 | ByVal | ❌ 不影響外部引用 | ✅ 影響外部對象內容 | 外部變量仍指向同一對象,但對象內容變了 |
| ByRef | ✅ 可改變外部引用指向 | ✅ 影響外部對象內容 | 外部變量可能指向新對象 |
記憶體模型圖解
ByVal (值類型 int a = 10)
棧: a=10 → 傳遞副本 → 方法內參數 n=10 → n=20 → 外部 a 仍為 10
ByRef (值類型 int a = 10)
棧: a=10 → 傳遞地址 → 方法內參數 別名 n → n=20 → 外部 a 變為 20
ByVal (引用類型 List o = new List())
堆: 對象O ← 棧: o → O → 傳遞引用副本 → 方法內參數 p → O
方法內 p = new List() → p 指向新對象 → 外部 o 仍指向 O (不變)
方法內 p.Add(1) → 修改 O 內容 → 外部 o 看到變化
ByRef (引用類型 List o = new List())
堆: 對象O ← 棧: o → O → 傳遞引用地址 → 方法內參數 別名 p → O
方法內 p = new List() → p 指向新對象 → 外部 o 也指向新對象 (變了!)
方法內 p.Add(1) → 修改 O 內容 → 外部 o 看到變化
代碼實驗
Module Demo
Sub ByValInt(ByVal n As Integer)
n += 100
Console.WriteLine($"方法內 n={n}")
End Sub
Sub ByRefInt(ByRef n As Integer)
n += 100
Console.WriteLine($"方法內 n={n}")
End Sub
Sub ByValList(ByVal list As List(Of String))
list.Add("ByVal 新增") ' 修改對象內容
list = New List(Of String) ' 修改參數引用指向
list.Add("新列表項目")
End Sub
Sub ByRefList(ByRef list As List(Of String))
list.Add("ByRef 新增")
list = New List(Of String)
list.Add("新列表項目")
End Sub
Sub Main()
Dim a = 10
ByValInt(a) : Console.WriteLine($"ByVal 後 a={a}") ' 10
ByRefInt(a) : Console.WriteLine($"ByRef 後 a={a}") ' 110
Dim lst1 As New List(Of String) From {"原始"}
ByValList(lst1)
Console.WriteLine($"ByValList 後: {String.Join(",", lst1)}") ' 原始,ByVal 新增
Dim lst2 As New List(Of String) From {"原始"}
ByRefList(lst2)
Console.WriteLine($"ByRefList 後: {String.Join(",", lst2)}") ' 新列表項目 (引用被換掉)
End Sub
End Module
常見誤區澄清
| 誤區 | 真相 |
| 「ByVal 禁止修改對象內容」 | ❌ ByVal 只保護引用不被替換,對象內容完全可改 |
| 「ByRef 就是傳對象」 | ❌ ByRef 傳的是變量的地址(指針的指針),可替換變量指向 |
| 「引用類型預設是 ByRef」 | ❌ 所有類型預設都是 ByVal,引用類型傳的是「引用的副本」 |
| 「加 ByRef 就能修改字符串」 | ⚠️ String 是不可變類型,任何「修改」實際是新建字符串,需 ByRef 才能讓外部見到新實例 |
最佳實踐指南
- 預設用 ByVal:除非明確需要「修改調用者的變量本身」(如 TryParse 模式、交換兩個變量)
- 輸出參數用 ByRef:
Function TryGetValue(key, ByRef value) As Boolean
- 避免 ByRef 傳遞引用類型:極易產生「誰負責對象生命週期」的混淆,改回傳值或用 Tuple/ValueTuple 返回多值
- 大型結構體:考慮
ByRef + readonly (C# in),避免複製開銷,同時防止修改
- 文檔化意圖:
''' <param name="result" ByRef>輸出參數</param>
對比:C# 對應關係
| VB.NET | C# | 備註 |
ByVal | (預設無關鍵字) | 值傳遞 |
ByRef | ref | 參考傳遞,可修改變量本身 |
| 無直接對應 | out | 僅輸出,調用前無需初始化 |
| 無直接對應 | in | 唯讀參考傳遞,避免大結構體複製 |
理解「傳遞的是什麼(值/引用/地址)」+「能否修改指向」,ByVal/ByRef 就不再是迷題。原則:**預設 ByVal,按需 ByRef,引用類型慎用 ByRef**。