Had Pemangkasan & Pantulan
Kendalikan amaran pemangkasan, gunakan [DynamicallyAccessedMembers] dan gantikan pantulan masa jalan dengan alternatif yang dijana daripada kod sumber.
Had Pemangkasan & Pantulan ialah pelajaran Akademi C# percuma di CoddyKit. Ini ialah pelajaran 2 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Akademi C#, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Akademi C# merangkumi sejumlah 4 pelajaran.
Apakah Pemangkasan IL?
Pemangkasan IL ialah pengoptimuman pada masa penerbitan yang mengalih keluar jenis, kaedah dan himpunan yang tidak digunakan daripada hasil penerbitan. Hasilnya ialah fail boleh laksana yang lebih kecil. Ciri ini didayakan secara automatik untuk Native AOT dan penerbitan satu fail kendiri.
Mendayakan Pemangkasan
Dayakan pemangkasan dalam fail projek. Anda boleh mengawal mod pemangkasan daripada partial (hanya memangkas himpunan yang tidak digunakan) hingga full (memangkas ahli yang tidak digunakan dalam himpunan).
// .csproj
<PropertyGroup>
<!-- Enable trimming on publish -->
<PublishTrimmed>true</PublishTrimmed>
<!-- full: aggressive — trims unused members within assemblies
partial: conservative — only removes unused assemblies -->
<TrimMode>full</TrimMode>
<!-- Treat all trimmer warnings as errors (recommended for CI) -->
<TrimmerRootAssemblies>MyApp</TrimmerRootAssemblies>
<SuppressTrimAnalysisWarnings>false</SuppressTrimAnalysisWarnings>
</PropertyGroup>
// Publish:
dotnet publish -c Release -r linux-x64 --self-containedCara Pemangkas Berfungsi
Pemangkas melakukan analisis kebolehcapaian bermula daripada titik masuk (Main, perkhidmatan yang didaftarkan, atribut). Sebarang kod yang tidak boleh dicapai daripada akar tersebut akan dialih keluar.
// Example: only MyApp.Program.Main is a root
// Code flow:
// Main → WebApplication.Run → MapGet → MyHandler
// Everything else is trimmed
// What gets KEPT:
class MyHandler { public string Handle() => "ok"; }
// What gets TRIMMED (if not reached):
class UnusedService { public void DoWork() { } }
// Problem: reflection can access UnusedService at runtime
// But the trimmer can't know that at compile time
// → UnusedService is trimmed → MissingMethodException at runtimeRefleksi dan Pemangkasan
Refleksi ialah punca utama ketidakserasian pemangkasan. Pemangkas tidak dapat menganalisis secara statik jenis yang akan anda akses melalui Type.GetType() atau Activator.CreateInstance().
// PROBLEMATIC: type name comes from config at runtime
var typeName = config["Plugin:Type"]!;
var type = Type.GetType(typeName); // type may have been trimmed!
var instance = Activator.CreateInstance(type!); // MissingMethodException
// PROBLEMATIC: LINQ expressions with reflection
var query = dbContext.Set<T>() // T discovered via reflection
.Where(BuildExpression<T>("Name", "Alice"));
// PROBLEMATIC: attribute scanning
var handlers = Assembly.GetExecutingAssembly()
.GetTypes()
.Where(t => t.HasCustomAttribute<HandlerAttribute>());
// All handler types may be trimmed awayAtribut DynamicDependency
[DynamicDependency] memberitahu pemangkas supaya mengekalkan ahli tertentu yang anda tahu akan diakses melalui refleksi.
// Keep all public constructors of MyPlugin:
[DynamicDependency(
DynamicallyAccessedMemberTypes.PublicConstructors,
typeof(MyPlugin))]
public static IPlugin CreatePlugin()
=> (IPlugin)Activator.CreateInstance(typeof(MyPlugin))!;
// Keep a specific method by name:
[DynamicDependency("ProcessOrder", typeof(OrderHandler))]
public static void Bootstrap() { }
// Keep everything on a type (use sparingly):
[DynamicDependency(
DynamicallyAccessedMemberTypes.All,
typeof(LegacyReflectionHelper))]
public static void EnsurePreserved() { }Anotasi DynamicallyAccessedMembers
[DynamicallyAccessedMembers] menganotasi parameter, medan dan sifat untuk memberitahu pemangkas ahli sesuatu Type yang akan diakses secara reflektif semasa masa jalan.
// Annotate a method parameter:
public void Register(
[DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicConstructors)]
Type serviceType)
{
// trimmer knows to preserve public constructors of whatever Type is passed
var instance = Activator.CreateInstance(serviceType)!;
}
// Annotate a generic parameter:
public static T Create<
[DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
T>() where T : new()
=> new T();
// Annotate a field:
[DynamicallyAccessedMembers(DynamicallyAccessedMemberTypes.PublicProperties)]
private Type _modelType = typeof(OrderModel);RequiresUnreferencedCode
Tandakan kaedah yang pada asasnya bergantung pada refleksi dengan [RequiresUnreferencedCode]. Ini memaparkan amaran kepada pemanggil supaya mereka tahu bahawa kod tersebut mungkin gagal apabila dipangkas.
// Mark a method that uses reflection internally:
[RequiresUnreferencedCode("Uses Type.GetType() — not safe for trimming")]
public static object LoadPlugin(string typeName)
{
var type = Type.GetType(typeName)!
?? throw new InvalidOperationException($"Type {typeName} not found");
return Activator.CreateInstance(type)!;
}
// Callers will see a trimmer warning:
// IL2026: Members decorated with [RequiresUnreferencedCode]
// need their callers to be decorated with the same attribute
// or be suppressed with [UnconditionalSuppressMessage]
// The warning reminds callers to use a trim-safe alternative
// or add a DynamicDependency for the types they expectAlternatif Selamat untuk Pemangkasan
Banyak corak yang menggunakan refleksi secara intensif mempunyai alternatif yang selamat untuk pemangkasan dalam .NET moden. Utamakan alternatif ini untuk mengelakkan isu pemangkasan.
// INSTEAD OF: Type.GetType(name) + Activator.CreateInstance
// USE: registered factories or switch expressions:
public IHandler CreateHandler(string name) => name switch
{
"order" => new OrderHandler(),
"email" => new EmailHandler(),
_ => throw new ArgumentException($"Unknown: {name}")
};
// INSTEAD OF: reflection-based JSON serialization
// USE: source-generated JsonSerializerContext
// INSTEAD OF: attribute scanning via Assembly.GetTypes()
// USE: compile-time source generators
// INSTEAD OF: dynamic proxy libraries (Castle, DispatchProxy)
// USE: source-generated interceptors (.NET 8+)XML Deskriptor Pemangkasan
Gunakan deskriptor akar XML untuk mengekalkan seluruh ruang nama atau himpunan yang tidak dapat dianalisis oleh pemangkas — contohnya, pustaka pihak ketiga yang banyak menggunakan refleksi.
<!-- TrimmerRoots.xml -->
<linker>
<!-- Keep everything in LegacyLib -->
<assembly fullname="LegacyLib">
<type fullname="LegacyLib.*" preserve="all" />
</assembly>
<!-- Keep a specific type -->
<assembly fullname="MyApp">
<type fullname="MyApp.Plugins.PluginLoader" preserve="all" />
</assembly>
</linker>
// Reference in .csproj:
<ItemGroup>
<TrimmerRootDescriptor Include="TrimmerRoots.xml" />
</ItemGroup>Contoh Dunia Sebenar: Membetulkan Amaran Pemangkasan
Aliran kerja praktikal untuk menyelesaikan amaran pemangkas dalam pangkalan kod sebenar.
// Step 1: enable analyzer during development
// .csproj:
<EnableTrimAnalyzer>true</EnableTrimAnalyzer>
// Step 2: build and read warnings:
// warning IL2026: 'MyMapper.MapDynamic(Type)' uses
// [RequiresUnreferencedCode] via 'Type.GetMethod'
// Step 3: fix the root cause:
// BEFORE:
public void MapDynamic(Type t)
{
var method = t.GetMethod("MapFrom")!; // IL2026
method.Invoke(null, null);
}
// AFTER: use an interface instead of reflection
public void Map(IMapper mapper) => mapper.MapFrom();
// Step 4: if fix is not feasible, add annotation and document:
[RequiresUnreferencedCode("Uses reflection: ensure target types are preserved")]
public void MapDynamic(Type t) { /* ... */ }Semakan Pantas
Apakah yang diberitahu oleh atribut [DynamicallyAccessedMembers] kepada pemangkas IL?
Ringkasan: Batasan Pemangkasan & Refleksi
Kesimpulan utama:
- Pemangkasan mengalih keluar kod yang tidak boleh dicapai pada masa penerbitan — refleksi mengganggu analisis ini
- Dayakan dengan
<PublishTrimmed>true</PublishTrimmed>; gunakanTrimMode=fulluntuk penjimatan maksimum [DynamicDependency]: mengekalkan ahli tertentu secara jelas untuk refleksi[DynamicallyAccessedMembers]: menganotasi parameterTypesupaya pemangkas tahu perkara yang perlu dikekalkan[RequiresUnreferencedCode]: memberi amaran kepada pemanggil bahawa sesuatu kaedah tidak selamat untuk pemangkasan- Utamakan penjana sumber dan antara muka berbanding corak yang banyak menggunakan refleksi
Pelajari C# dengan tutor kecerdasan buatan — percuma
Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.
- Kursus
- 93
- Pelajaran
- 346
Soalan Lazim
Adakah pelajaran “Had Pemangkasan & Pantulan” percuma?
Ya — teks penuh “Had Pemangkasan & Pantulan” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus Akademi C#, tingkat taraf kepada CoddyKit PRO. Kursus Akademi C# merangkumi sejumlah 4 pelajaran.
Apakah yang akan saya pelajari dalam “Had Pemangkasan & Pantulan”?
Kendalikan amaran pemangkasan, gunakan [DynamicallyAccessedMembers] dan gantikan pantulan masa jalan dengan alternatif yang dijana daripada kod sumber. Anda berlatih Akademi C# menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.
Adakah saya memerlukan pengalaman untuk memulakan Akademi C#?
Tiada pengalaman terdahulu diperlukan. Pembelajaran Akademi C# di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 2 daripada 4.
Berapa lamakah pelajaran “Had Pemangkasan & Pantulan” diambil?
Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.
Bolehkah saya menulis dan menjalankan kod dalam pelajaran Akademi C# ini?
Ya. Setiap pelajaran Akademi C# menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.
Semua pelajaran dalam kursus ini
- Kompilasi AOT Asli
- Had Pemangkasan & Pantulan
- ReadyToRun & Kompilasi Berperingkat
- Penanda Aras dengan BenchmarkDotNet