{"id":585,"date":"2026-04-03T10:36:55","date_gmt":"2026-04-03T02:36:55","guid":{"rendered":"https:\/\/www.hyw.life\/?p=585"},"modified":"2026-04-03T11:03:41","modified_gmt":"2026-04-03T03:03:41","slug":"net-minipdf-%e9%9b%86%e6%88%90%e5%bc%80%e5%8f%91%e8%af%a6%e7%bb%86%e8%af%b4%e6%98%8e%e6%96%87%e6%a1%a3","status":"publish","type":"post","link":"https:\/\/www.hyw.life\/?p=585","title":{"rendered":".NET MiniPdf \u96c6\u6210\u5f00\u53d1\u8be6\u7ec6\u8bf4\u660e\u6587\u6863"},"content":{"rendered":"\n
\n

\u7248\u672c<\/strong>\uff1a\u9002\u7528\u4e8e MiniPdf 0.16.0 \u53ca\u4ee5\u4e0a\u7248\u672c
\u8bb8\u53ef\u534f\u8bae<\/strong>\uff1aApache 2.0\uff0c\u5f00\u6e90\u53ef\u514d\u8d39\u5546\u7528
\u5b98\u65b9\u4ed3\u5e93<\/strong>\uff1a<\/a>https:\/\/github.com\/mini-software\/MiniPdf<\/a><\/p>\n<\/blockquote>\n\n\n\n

\n\n\n\n<\/span>

\u76ee\u5f55<\/h2>\n\n\n\n
    \n
  1. \u6982\u8ff0<\/a><\/li>\n\n\n\n
  2. \u73af\u5883\u8981\u6c42<\/a><\/li>\n\n\n\n
  3. \u5b89\u88c5\u65b9\u5f0f<\/a><\/li>\n\n\n\n
  4. \u5feb\u901f\u5f00\u59cb<\/a><\/li>\n\n\n\n
  5. API \u53c2\u8003<\/a><\/li>\n\n\n\n
  6. \u8fdb\u9636\u4f7f\u7528<\/a><\/li>\n\n\n\n
  7. \u547d\u4ee4\u884c\u5de5\u5177\uff08MiniPdf.Cli\uff09<\/a><\/li>\n\n\n\n
  8. \u5728 Web \u9879\u76ee\u4e2d\u96c6\u6210<\/a><\/li>\n\n\n\n
  9. \u5bb9\u5668\/Docker \u73af\u5883\u96c6\u6210<\/a><\/li>\n\n\n\n
  10. \u529f\u80fd\u652f\u6301\u8bf4\u660e\u4e0e\u5c40\u9650\u6027<\/a><\/li>\n\n\n\n
  11. \u6027\u80fd\u4e0e\u57fa\u51c6\u6d4b\u8bd5<\/a><\/li>\n\n\n\n
  12. \u5e38\u89c1\u95ee\u9898 FAQ<\/a><\/li>\n\n\n\n
  13. \u76f8\u5173\u8d44\u6e90<\/a><\/li>\n<\/ol>\n\n\n\n
    \n\n\n\n<\/span>

    1. \u6982\u8ff0<\/h2>\n\n\n\n<\/span>

    1.1 \u4ec0\u4e48\u662f MiniPdf<\/h3>\n\n\n\n

    MiniPdf<\/strong> \u662f\u7531 mini-software \u56e2\u961f\uff08MiniExcel\u3001MiniWord \u540c\u4f5c\u8005\uff09\u5f00\u53d1\u7684\u4e00\u4e2a\u6781\u7b80\u3001\u96f6\u5916\u90e8\u4f9d\u8d56\u7684 .NET \u5e93\uff0c\u4e13\u4e3a\u5c06 Office \u6587\u4ef6\uff08Excel .xlsx<\/code>\u3001Word .docx<\/code>\uff09\u8f6c\u6362\u4e3a PDF \u800c\u8bbe\u8ba1\u3002<\/p>\n\n\n\n

    \u5b83\u5b8c\u5168\u57fa\u4e8e .NET \u5185\u7f6e API \u5b9e\u73b0\uff0c\u65e0\u9700\u5b89\u88c5 Microsoft Office\u3001LibreOffice\u3001Adobe Acrobat<\/strong> \u6216\u4efb\u4f55\u7b2c\u4e09\u65b9\u8f6f\u4ef6\uff0c\u662f\u76ee\u524d\u5168\u7403\u9996\u4e2a\u5f00\u6e90\u53ef\u5546\u7528\u7684 .NET Office \u8f6c PDF \u5de5\u5177\u3002<\/p>\n\n\n\n<\/span>

    1.2 \u6838\u5fc3\u4f18\u52bf<\/h3>\n\n\n
    \n\n\n\n\n\n\n\n\n\n\n\n
    \u4f18\u52bf<\/th>\n\u8bf4\u660e<\/th>\n<\/tr>\n<\/thead>\n
    \u00a0\u96f6\u4f9d\u8d56<\/td>\n\u4e0d\u4f9d\u8d56 COM\u3001Office\u3001LibreOffice\u3001Docker<\/td>\n<\/tr>\n
    \u8f7b\u91cf\u5316<\/td>\n\u4ec5\u4f7f\u7528 .NET \u5185\u7f6e API\uff0c\u5305\u4f53\u79ef\u5c0f<\/td>\n<\/tr>\n
    \u514d\u8d39\u5546\u7528<\/td>\nApache 2.0 \u534f\u8bae\uff0c\u4f01\u4e1a\u9879\u76ee\u53ef\u76f4\u63a5\u4f7f\u7528<\/td>\n<\/tr>\n
    \u00a0\u8de8\u5e73\u53f0<\/td>\n\u652f\u6301 Windows \/ Linux \/ macOS<\/td>\n<\/tr>\n
    \u00a0Serverless \u5c31\u7eea<\/td>\n\u9002\u5408\u4e91\u51fd\u6570\u3001\u5bb9\u5668\u5316\u90e8\u7f72<\/td>\n<\/tr>\n
    \u6807\u51c6\u8f93\u51fa<\/td>\n\u751f\u6210\u7b26\u5408 PDF 1.4 \u6807\u51c6\u7684\u6587\u4ef6<\/td>\n<\/tr>\n
    \u00a0Native AOT<\/td>\n\u652f\u6301\u7f16\u8bd1\u4e3a\u96f6\u4f9d\u8d56\u7684\u539f\u751f\u53ef\u6267\u884c\u6587\u4ef6<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n\n\n<\/span>

    1.3 \u5185\u90e8\u6280\u672f\u67b6\u6784<\/h3>\n\n\n\n
    MiniPdf.ConvertToPdf\uff08\u516c\u5171 API \u5165\u53e3\uff09\n         \u2502\n         \u251c\u2500\u2192 ExcelToPdfConverter\uff08Excel \u89e3\u6790 + \u5e03\u5c40\u5f15\u64ce\uff09\n         \u2502           \u2502\n         \u2502           \u2514\u2500\u2192 ExcelReader\uff08\u89e3\u6790 .xlsx Open XML\uff09\n         \u2502\n         \u251c\u2500\u2192 WordToPdfConverter\uff08Word \u89e3\u6790 + \u5e03\u5c40\u5f15\u64ce\uff09\n         \u2502\n         \u2514\u2500\u2192 PdfWriter\uff08PDF 1.4 \u6587\u6863\u751f\u6210\u5668\uff09\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n<\/span>
    2. \u73af\u5883\u8981\u6c42<\/h2>\n\n\n\n<\/span>
    2.1 \u652f\u6301\u7684 .NET \u6846\u67b6\u7248\u672c<\/h3>\n\n\n
    \n\n\n\n\n\n\n\n
    \u6846\u67b6<\/th>\n\u6700\u4f4e\u7248\u672c<\/th>\n<\/tr>\n<\/thead>\n
    .NET Framework<\/td>\n4.6.2<\/td>\n<\/tr>\n
    .NET Standard<\/td>\n2.0<\/td>\n<\/tr>\n
    .NET Core \/ .NET<\/td>\n6.0\u30018.0\u30019.0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n\n\n<\/span>
    2.2 \u4f9d\u8d56\u8bf4\u660e<\/h3>\n\n\n
    \n\n\n\n\n\n\n\n
    \u76ee\u6807\u6846\u67b6<\/th>\n\u6240\u9700\u4f9d\u8d56<\/th>\n<\/tr>\n<\/thead>\n
    .NET Framework 4.6.2<\/td>\nSystem.Memory \u2265 4.5.5<\/code>\u3001System.ValueTuple \u2265 4.5.0<\/code><\/td>\n<\/tr>\n
    .NET Standard 2.0<\/td>\nSystem.Drawing.Common \u2265 8.0.0<\/code>\u3001System.Memory \u2265 4.5.5<\/code><\/td>\n<\/tr>\n
    .NET 6.0 \/ 8.0 \/ 9.0<\/td>\nSystem.Drawing.Common \u2265 8.0.0<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n\n\n
    \n
    \u4ee5\u4e0a\u4f9d\u8d56\u5747\u7531 NuGet \u81ea\u52a8\u7ba1\u7406\uff0c\u65e0\u9700\u624b\u52a8\u5b89\u88c5\u3002<\/p>\n<\/blockquote>\n\n\n\n
    \n\n\n\n<\/span>
    3. \u5b89\u88c5\u65b9\u5f0f<\/h2>\n\n\n\n<\/span>
    3.1 .NET CLI\uff08\u63a8\u8350\uff09<\/h3>\n\n\n\n
    dotnet add package MiniPdf\n<\/code><\/pre>\n\n\n\n
    \u5b89\u88c5\u6307\u5b9a\u7248\u672c\uff1a<\/p>\n\n\n\n
    dotnet add package MiniPdf --version 0.16.0\n<\/code><\/pre>\n\n\n\n<\/span>
    3.2 Visual Studio Package Manager Console<\/h3>\n\n\n\n
    Install-Package MiniPdf\n<\/code><\/pre>\n\n\n\n
    \u5b89\u88c5\u6307\u5b9a\u7248\u672c\uff1a<\/p>\n\n\n\n
    Install-Package MiniPdf -Version 0.16.0\n<\/code><\/pre>\n\n\n\n<\/span>
    3.3 \u9879\u76ee\u6587\u4ef6\uff08.csproj\uff09\u76f4\u63a5\u5f15\u7528<\/h3>\n\n\n\n
    \u5728 .csproj<\/code> \u6587\u4ef6\u7684 <ItemGroup><\/code> \u4e2d\u6dfb\u52a0\uff1a<\/p>\n\n\n\n
    <ItemGroup>\n  <PackageReference Include=\"MiniPdf\" Version=\"0.16.0\" \/>\n<\/ItemGroup>\n<\/code><\/pre>\n\n\n\n<\/span>
    3.4 Paket CLI<\/h3>\n\n\n\n
    paket add MiniPdf --version 0.16.0\n<\/code><\/pre>\n\n\n\n<\/span>
    3.5 F# Interactive \/ Polyglot Notebooks<\/h3>\n\n\n\n
    #r \"nuget: MiniPdf, 0.16.0\"\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n<\/span>
    4. \u5feb\u901f\u5f00\u59cb<\/h2>\n\n\n\n<\/span>
    4.1 \u5f15\u5165\u547d\u540d\u7a7a\u95f4<\/h3>\n\n\n\n
    \u6240\u6709\u529f\u80fd\u5747\u901a\u8fc7 MiniSoftware<\/code> \u547d\u540d\u7a7a\u95f4\u4e0b\u7684 MiniPdf<\/code> \u9759\u6001\u7c7b\u63d0\u4f9b\uff1a<\/p>\n\n\n\n
    using MiniSoftware;\n<\/code><\/pre>\n\n\n\n<\/span>
    4.2 \u57fa\u7840\u793a\u4f8b\uff1aExcel \u8f6c PDF<\/h3>\n\n\n\n
    using MiniSoftware;\n\n\/\/ \u5c06 Excel \u6587\u4ef6\u8f6c\u6362\u4e3a PDF \u6587\u4ef6<\/em>\nMiniPdf.ConvertToPdf(\"data.xlsx\", \"output.pdf\");\n\nConsole.WriteLine(\"\u8f6c\u6362\u5b8c\u6210\uff01\");\n<\/code><\/pre>\n\n\n\n<\/span>
    4.3 \u57fa\u7840\u793a\u4f8b\uff1aWord \u8f6c PDF<\/h3>\n\n\n\n
    using MiniSoftware;\n\n\/\/ \u5c06 Word \u6587\u4ef6\u8f6c\u6362\u4e3a PDF \u6587\u4ef6<\/em>\nMiniPdf.ConvertToPdf(\"report.docx\", \"output.pdf\");\n\nConsole.WriteLine(\"\u8f6c\u6362\u5b8c\u6210\uff01\");\n<\/code><\/pre>\n\n\n\n<\/span>
    4.4 \u8fd4\u56de\u5b57\u8282\u6570\u7ec4\uff08\u4e0d\u5199\u5165\u6587\u4ef6\uff09<\/h3>\n\n\n\n
    using MiniSoftware;\n\n\/\/ \u8f6c\u6362\u540e\u8fd4\u56de PDF \u7684\u5b57\u8282\u6570\u7ec4\uff0c\u4e0d\u76f4\u63a5\u5199\u5165\u78c1\u76d8<\/em>\nbyte[] pdfBytes = MiniPdf.ConvertToPdf(\"data.xlsx\");\n\n\/\/ \u53ef\u5c06 pdfBytes \u4fdd\u5b58\u5230\u6570\u636e\u5e93\u3001\u8fd4\u56de\u7ed9\u524d\u7aef\u6216\u505a\u8fdb\u4e00\u6b65\u5904\u7406<\/em>\nFile.WriteAllBytes(\"output.pdf\", pdfBytes);\n<\/code><\/pre>\n\n\n\n<\/span>
    4.5 \u4ece\u6587\u4ef6\u6d41\u8f6c\u6362<\/h3>\n\n\n\n
    using MiniSoftware;\n\n\/\/ \u4ece\u6587\u4ef6\u6d41\u8bfb\u53d6 Excel\uff0c\u8fd4\u56de PDF \u5b57\u8282\u6570\u7ec4<\/em>\nusing var inputStream = File.OpenRead(\"data.xlsx\");\nbyte[] pdfBytes = MiniPdf.ConvertToPdf(inputStream);\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n<\/span>
    5. API \u53c2\u8003<\/h2>\n\n\n\n<\/span>
    5.1 \u9759\u6001\u65b9\u6cd5\u603b\u89c8<\/h3>\n\n\n\n
    MiniPdf<\/code> \u7c7b\u63d0\u4f9b\u4ee5\u4e0b\u9759\u6001\u65b9\u6cd5\uff08\u5747\u4f4d\u4e8e MiniSoftware<\/code> \u547d\u540d\u7a7a\u95f4\uff09\uff1a<\/p>\n\n\n
    \n\n\n\n\n\n\n\n\n\n
    \u65b9\u6cd5\u7b7e\u540d<\/th>\n\u8bf4\u660e<\/th>\n<\/tr>\n<\/thead>\n
    ConvertToPdf(string inputPath, string outputPath)<\/code><\/td>\n\u6587\u4ef6\u8def\u5f84 \u2192 \u6587\u4ef6\u8def\u5f84\uff08\u63a8\u8350\uff09<\/td>\n<\/tr>\n
    ConvertToPdf(string inputPath) : byte[]<\/code><\/td>\n\u6587\u4ef6\u8def\u5f84 \u2192 \u5b57\u8282\u6570\u7ec4<\/td>\n<\/tr>\n
    ConvertToPdf(Stream inputStream) : byte[]<\/code><\/td>\n\u8f93\u5165\u6d41 \u2192 \u5b57\u8282\u6570\u7ec4<\/td>\n<\/tr>\n
    ConvertToPdf(Stream inputStream, Stream outputStream)<\/code><\/td>\n\u8f93\u5165\u6d41 \u2192 \u8f93\u51fa\u6d41<\/td>\n<\/tr>\n
    RegisterFont(string fontName, byte[] fontBytes)<\/code><\/td>\n\u6ce8\u518c\u81ea\u5b9a\u4e49\u5b57\u4f53<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n\n\n<\/span>
    5.2 \u65b9\u6cd5\u8be6\u7ec6\u8bf4\u660e<\/h3>\n\n\n\n
    ConvertToPdf(string inputPath, string outputPath)<\/code><\/h4>\n\n\n\n
    \/\/\/ <summary><\/em>\n\/\/\/ \u5c06 Excel \u6216 Word \u6587\u4ef6\u8f6c\u6362\u4e3a PDF\uff0c\u76f4\u63a5\u5199\u5165\u76ee\u6807\u8def\u5f84<\/em>\n\/\/\/ <\/summary><\/em>\n\/\/\/ <param name=\"inputPath\">\u8f93\u5165\u6587\u4ef6\u8def\u5f84\uff0c\u652f\u6301 .xlsx \/ .docx<\/param><\/em>\n\/\/\/ <param name=\"outputPath\">\u8f93\u51fa PDF \u6587\u4ef6\u8def\u5f84<\/param><\/em>\npublic static void ConvertToPdf(string inputPath, string outputPath);\n<\/code><\/pre>\n\n\n\n
    \u793a\u4f8b\uff1a<\/strong><\/p>\n\n\n\n
    MiniPdf.ConvertToPdf(@\"C:\\Documents\\report.xlsx\", @\"C:\\Output\\report.pdf\");\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n
    ConvertToPdf(string inputPath) : byte[]<\/code><\/h4>\n\n\n\n
    \/\/\/ <summary><\/em>\n\/\/\/ \u5c06 Excel \u6216 Word \u6587\u4ef6\u8f6c\u6362\u4e3a PDF\uff0c\u8fd4\u56de\u5b57\u8282\u6570\u7ec4<\/em>\n\/\/\/ <\/summary><\/em>\n\/\/\/ <param name=\"inputPath\">\u8f93\u5165\u6587\u4ef6\u8def\u5f84\uff0c\u652f\u6301 .xlsx \/ .docx<\/param><\/em>\n\/\/\/ <returns>PDF \u6587\u4ef6\u7684\u5b57\u8282\u6570\u7ec4<\/returns><\/em>\npublic static byte[] ConvertToPdf(string inputPath);\n<\/code><\/pre>\n\n\n\n
    \u793a\u4f8b\uff1a<\/strong><\/p>\n\n\n\n
    byte[] pdfData = MiniPdf.ConvertToPdf(\"invoice.xlsx\");\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n
    ConvertToPdf(Stream inputStream) : byte[]<\/code><\/h4>\n\n\n\n
    \/\/\/ <summary><\/em>\n\/\/\/ \u4ece\u8f93\u5165\u6d41\u8bfb\u53d6 Office \u6587\u4ef6\uff0c\u8f6c\u6362\u4e3a PDF \u5b57\u8282\u6570\u7ec4<\/em>\n\/\/\/ <\/summary><\/em>\n\/\/\/ <param name=\"inputStream\">\u8f93\u5165\u6d41\uff08.xlsx \u6216 .docx \u683c\u5f0f\uff09<\/param><\/em>\n\/\/\/ <returns>PDF \u6587\u4ef6\u7684\u5b57\u8282\u6570\u7ec4<\/returns><\/em>\npublic static byte[] ConvertToPdf(Stream inputStream);\n<\/code><\/pre>\n\n\n\n
    \u793a\u4f8b\uff1a<\/strong><\/p>\n\n\n\n
    using var stream = File.OpenRead(\"report.xlsx\");\nbyte[] pdfBytes = MiniPdf.ConvertToPdf(stream);\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n
    RegisterFont(string fontName, byte[] fontBytes)<\/code><\/h4>\n\n\n\n
    \/\/\/ <summary><\/em>\n\/\/\/ \u6ce8\u518c\u81ea\u5b9a\u4e49\u5b57\u4f53\uff0c\u7528\u4e8e\u66ff\u6362\u7cfb\u7edf\u5b57\u4f53\uff08\u9002\u5408\u65e0\u5b57\u4f53\u73af\u5883\uff09<\/em>\n\/\/\/ \u5efa\u8bae\u5728\u5e94\u7528\u7a0b\u5e8f\u542f\u52a8\u65f6\u8c03\u7528\uff0c\u4ec5\u9700\u6ce8\u518c\u4e00\u6b21<\/em>\n\/\/\/ <\/summary><\/em>\n\/\/\/ <param name=\"fontName\">\u5b57\u4f53\u540d\u79f0\uff08\u81ea\u5b9a\u4e49\u6807\u8bc6\u7b26\uff09<\/param><\/em>\n\/\/\/ <param name=\"fontBytes\">\u5b57\u4f53\u6587\u4ef6\u7684\u5b57\u8282\u6570\u7ec4\uff08\u652f\u6301 .ttf \/ .ttc\uff09<\/param><\/em>\npublic static void RegisterFont(string fontName, byte[] fontBytes);\n<\/code><\/pre>\n\n\n\n
    \u793a\u4f8b\uff1a<\/strong><\/p>\n\n\n\n
    \/\/ \u7a0b\u5e8f\u542f\u52a8\u65f6\u6ce8\u518c\u5b57\u4f53\uff08Program.cs \u6216 Startup.cs\uff09<\/em>\nMiniPdf.RegisterFont(\"NotoSansSC\", File.ReadAllBytes(\"Fonts\/NotoSansSC-Regular.ttf\"));\nMiniPdf.RegisterFont(\"NotoColorEmoji\", File.ReadAllBytes(\"Fonts\/NotoColorEmoji.ttf\"));\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n<\/span>
    6. \u8fdb\u9636\u4f7f\u7528<\/h2>\n\n\n\n<\/span>
    6.1 \u81ea\u5b9a\u4e49\u5b57\u4f53\uff08\u89e3\u51b3\u4e2d\u6587\u4e71\u7801\/\u5b57\u4f53\u7f3a\u5931\uff09<\/h3>\n\n\n\n
    \u5728 Docker \u5bb9\u5668\u3001Blazor WASM\u3001Serverless \u7b49\u65e0\u5b57\u4f53\u73af\u5883\u4e2d\uff0c\u7cfb\u7edf\u53ef\u80fd\u7f3a\u5c11\u4e2d\u6587\u5b57\u4f53\uff0c\u5bfc\u81f4\u751f\u6210\u7684 PDF \u51fa\u73b0\u65b9\u6846\u6216\u4e71\u7801\u3002
    \u89e3\u51b3\u65b9\u6848\uff1a\u5728\u7a0b\u5e8f\u542f\u52a8\u65f6\u6ce8\u518c\u81ea\u5b9a\u4e49\u5b57\u4f53\u3002<\/p>\n\n\n\n
    \u6b65\u9aa4\u4e00\uff1a\u4e0b\u8f7d\u4e2d\u6587\u5b57\u4f53<\/strong><\/p>\n\n\n\n
    \u63a8\u8350\u4f7f\u7528 Noto Sans SC\uff08\u601d\u6e90\u9ed1\u4f53\uff09<\/a>\uff0c\u5f00\u6e90\u514d\u8d39\u53ef\u5546\u7528\u3002<\/p>\n\n\n\n
    \u6b65\u9aa4\u4e8c\uff1a\u5c06\u5b57\u4f53\u6587\u4ef6\u653e\u5165\u9879\u76ee<\/strong><\/p>\n\n\n\n
    MyProject\/\n\u251c\u2500\u2500 Fonts\/\n\u2502   \u2514\u2500\u2500 NotoSansSC-Regular.ttf\n\u251c\u2500\u2500 Program.cs\n<\/code><\/pre>\n\n\n\n
    \u786e\u4fdd\u5b57\u4f53\u6587\u4ef6\u88ab\u590d\u5236\u5230\u8f93\u51fa\u76ee\u5f55\uff08.csproj<\/code>\uff09\uff1a<\/p>\n\n\n\n
    <ItemGroup>\n  <None Update=\"Fonts\\NotoSansSC-Regular.ttf\">\n    <CopyToOutputDirectory>Always<\/CopyToOutputDirectory>\n  <\/None>\n<\/ItemGroup>\n<\/code><\/pre>\n\n\n\n
    \u6b65\u9aa4\u4e09\uff1a\u6ce8\u518c\u5b57\u4f53<\/strong><\/p>\n\n\n\n
    \/\/ Program.cs\uff08\u4ec5\u9700\u5728\u5e94\u7528\u542f\u52a8\u65f6\u6267\u884c\u4e00\u6b21\uff09<\/em>\nMiniPdf.RegisterFont(\"NotoSansSC\", File.ReadAllBytes(\"Fonts\/NotoSansSC-Regular.ttf\"));\n<\/code><\/pre>\n\n\n\n
    \u6b65\u9aa4\u56db\uff1a\u6b63\u5e38\u8c03\u7528\u8f6c\u6362<\/strong><\/p>\n\n\n\n
    \/\/ \u6ce8\u518c\u5b57\u4f53\u540e\uff0c\u6b63\u5e38\u8c03\u7528\u5373\u53ef\uff0c\u5b57\u4f53\u4f1a\u81ea\u52a8\u5339\u914d<\/em>\nMiniPdf.ConvertToPdf(\"report.xlsx\", \"report.pdf\");\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n<\/span>
    6.2 \u591a\u5b57\u4f53\u6ce8\u518c\u793a\u4f8b<\/h3>\n\n\n\n
    \/\/ \u652f\u6301\u591a\u79cd\u5b57\u4f53\uff0c\u6309\u540d\u79f0\u6ce8\u518c<\/em>\nMiniPdf.RegisterFont(\"SimSun\", File.ReadAllBytes(\"Fonts\/simsun.ttf\"));         \/\/ \u5b8b\u4f53<\/em>\nMiniPdf.RegisterFont(\"SimHei\", File.ReadAllBytes(\"Fonts\/simhei.ttf\"));         \/\/ \u9ed1\u4f53<\/em>\nMiniPdf.RegisterFont(\"NotoEmoji\", File.ReadAllBytes(\"Fonts\/NotoColorEmoji.ttf\")); \/\/ Emoji<\/em>\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n<\/span>
    6.3 \u5f02\u5e38\u5904\u7406<\/h3>\n\n\n\n
    \u5efa\u8bae\u5bf9\u8f6c\u6362\u903b\u8f91\u8fdb\u884c\u5f02\u5e38\u6355\u83b7\uff1a<\/p>\n\n\n\n
    using MiniSoftware;\n\ntry\n{\n    MiniPdf.ConvertToPdf(\"input.xlsx\", \"output.pdf\");\n    Console.WriteLine(\"\u8f6c\u6362\u6210\u529f\");\n}\ncatch (FileNotFoundException ex)\n{\n    Console.WriteLine($\"\u6587\u4ef6\u672a\u627e\u5230\uff1a{ex.Message}\");\n}\ncatch (UnauthorizedAccessException ex)\n{\n    Console.WriteLine($\"\u6587\u4ef6\u8bbf\u95ee\u6743\u9650\u4e0d\u8db3\uff1a{ex.Message}\");\n}\ncatch (Exception ex)\n{\n    Console.WriteLine($\"\u8f6c\u6362\u5931\u8d25\uff1a{ex.Message}\");\n}\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n<\/span>
    6.4 \u6279\u91cf\u8f6c\u6362<\/h3>\n\n\n\n
    \n\n\n\n<\/span>
    7. \u547d\u4ee4\u884c\u5de5\u5177\uff08MiniPdf.Cli\uff09<\/h2>\n\n\n\n<\/span>
    7.1 \u5b89\u88c5 CLI \u5de5\u5177<\/h3>\n\n\n\n
    dotnet tool install --global MiniPdf.Cli\n<\/code><\/pre>\n\n\n\n
    \u9a8c\u8bc1\u5b89\u88c5\uff1a<\/p>\n\n\n\n
    minipdf --version\n<\/code><\/pre>\n\n\n\n<\/span>
    7.2 \u57fa\u672c\u547d\u4ee4<\/h3>\n\n\n\n
    # \u5c06 Excel \u8f6c\u4e3a PDF\uff08\u8f93\u51fa\u5230\u540c\u76ee\u5f55\uff0c\u540c\u540d .pdf \u6587\u4ef6\uff09<\/em>\nminipdf data.xlsx\n\n# \u5c06 Word \u8f6c\u4e3a PDF<\/em>\nminipdf report.docx\n\n# \u6307\u5b9a\u8f93\u51fa\u8def\u5f84<\/em>\nminipdf report.docx -o \/path\/to\/output.pdf\nminipdf data.xlsx --output .\/result\/output.pdf\n\n# \u6307\u5b9a\u5b57\u4f53\u76ee\u5f55\uff08\u6279\u91cf\u6ce8\u518c\u76ee\u5f55\u4e0b\u6240\u6709\u5b57\u4f53\uff09<\/em>\nminipdf report.docx --fonts .\/Fonts\n\n# \u67e5\u770b\u5e2e\u52a9<\/em>\nminipdf --help\n<\/code><\/pre>\n\n\n\n<\/span>
    7.3 \u4f7f\u7528 Native AOT \u72ec\u7acb\u4e8c\u8fdb\u5236\uff08\u65e0\u9700 .NET \u8fd0\u884c\u65f6\uff09<\/h3>\n\n\n\n
    \u9002\u7528\u4e8e\u670d\u52a1\u5668\u65e0 .NET \u8fd0\u884c\u65f6\u73af\u5883\uff0c\u4e0b\u8f7d\u7f16\u8bd1\u597d\u7684\u539f\u751f\u53ef\u6267\u884c\u6587\u4ef6\uff1a<\/p>\n\n\n\n
    \u4e0b\u8f7d\u5730\u5740<\/strong>\uff1aGitHub Releases<\/a><\/p>\n\n\n\n
    Windows \u4f7f\u7528\uff1a<\/strong><\/p>\n\n\n\n
    # \u89e3\u538b\u540e\u76f4\u63a5\u8fd0\u884c\n.\\minipdf.exe report.docx -o report.pdf\n.\\minipdf.exe data.xlsx --fonts .\\Fonts -o output.pdf\n<\/code><\/pre>\n\n\n\n
    Linux \u4f7f\u7528\uff1a<\/strong><\/p>\n\n\n\n
    # \u89e3\u538b<\/em>\ntar -xzf minipdf-linux-x64.tar.gz\n\n# \u8d4b\u6743<\/em>\nchmod +x minipdf\n\n# \u6267\u884c\u8f6c\u6362<\/em>\n.\/minipdf report.docx -o report.pdf\n.\/minipdf data.xlsx --fonts .\/Fonts\n<\/code><\/pre>\n\n\n\n
    macOS \u4f7f\u7528\uff1a<\/strong><\/p>\n\n\n\n
    tar -xzf minipdf-osx-x64.tar.gz\nchmod +x minipdf\n.\/minipdf data.xlsx -o output.pdf\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n<\/span>
    8. \u5728 Web \u9879\u76ee\u4e2d\u96c6\u6210<\/h2>\n\n\n\n<\/span>
    8.1 ASP.NET Core Web API \u793a\u4f8b<\/h3>\n\n\n\n
    \u5728 HTTP \u63a5\u53e3\u4e2d\u63a5\u6536\u6587\u4ef6\uff0c\u8f6c\u6362\u540e\u76f4\u63a5\u8fd4\u56de PDF \u6d41\uff1a<\/p>\n\n\n\n
    using Microsoft.AspNetCore.Mvc;\nusing MiniSoftware;\n\n[ApiController]\n[Route(\"api\/[controller]\")]\npublic class PdfController : ControllerBase\n{\n    \/\/\/ <summary>\n    \/\/\/ \u4e0a\u4f20 Excel\/Word \u6587\u4ef6\uff0c\u8fd4\u56de\u8f6c\u6362\u540e\u7684 PDF\n    \/\/\/ <\/summary>\n    [HttpPost(\"convert\")]\n    public IActionResult ConvertToPdf(IFormFile file)\n    {\n        if (file == null || file.Length == 0)\n            return BadRequest(\"\u8bf7\u4e0a\u4f20\u6587\u4ef6\");\n\n        var ext = Path.GetExtension(file.FileName).ToLower();\n        if (ext != \".xlsx\" && ext != \".docx\")\n            return BadRequest(\"\u4ec5\u652f\u6301 .xlsx \u548c .docx \u683c\u5f0f\");\n\n        try\n        {\n            using var inputStream = file.OpenReadStream();\n            byte[] pdfBytes = MiniPdf.ConvertToPdf(inputStream);\n\n            return File(pdfBytes, \"application\/pdf\", \n                Path.GetFileNameWithoutExtension(file.FileName) + \".pdf\");\n        }\n        catch (Exception ex)\n        {\n            return StatusCode(500, $\"\u8f6c\u6362\u5931\u8d25\uff1a{ex.Message}\");\n        }\n    }\n}<\/code><\/pre>\n\n\n\n<\/span>
    8.2 ASP.NET Core Minimal API \u793a\u4f8b<\/h3>\n\n\n\n
    using MiniSoftware;\n\nvar builder = WebApplication.CreateBuilder(args);\n\n\/\/ \u6ce8\u518c\u5b57\u4f53\uff08\u9002\u5408\u5bb9\u5668\u73af\u5883\uff09<\/em>\nMiniPdf.RegisterFont(\"NotoSansSC\", \n    File.ReadAllBytes(\"Fonts\/NotoSansSC-Regular.ttf\"));\n\nvar app = builder.Build();\n\napp.MapPost(\"\/convert\", async (IFormFile file) =>\n{\n    using var stream = file.OpenReadStream();\n    var pdfBytes = MiniPdf.ConvertToPdf(stream);\n    return Results.File(pdfBytes, \"application\/pdf\", \n        Path.ChangeExtension(file.FileName, \".pdf\"));\n});\n\napp.Run();\n<\/code><\/pre>\n\n\n\n<\/span>
    8.3 \u4e0b\u8f7d PDF \u5230\u6d4f\u89c8\u5668\uff08\u5185\u8054\/\u9644\u4ef6\uff09<\/h3>\n\n\n\n
    \/\/ \u5728\u6d4f\u89c8\u5668\u4e2d\u76f4\u63a5\u9884\u89c8 PDF\uff08\u5185\u8054\uff09<\/em>\nResponse.Headers[\"Content-Disposition\"] = \"inline; filename=output.pdf\";\nResponse.ContentType = \"application\/pdf\";\nawait Response.Body.WriteAsync(pdfBytes);\n\n\/\/ \u6216\u4f5c\u4e3a\u9644\u4ef6\u4e0b\u8f7d<\/em>\nreturn File(pdfBytes, \"application\/pdf\", \"output.pdf\");\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n<\/span>
    9. \u5bb9\u5668\/Docker \u73af\u5883\u96c6\u6210<\/h2>\n\n\n\n<\/span>
    9.1 Dockerfile \u793a\u4f8b<\/h3>\n\n\n\n
    \u7531\u4e8e MiniPdf \u65e0\u9700 LibreOffice \/ Office\uff0cDockerfile \u6781\u4e3a\u7b80\u6d01\uff1a<\/p>\n\n\n\n
    FROM mcr.microsoft.com\/dotnet\/aspnet:8.0 AS base\nWORKDIR \/app\nEXPOSE 80\n\n# \u5b89\u88c5\u4e2d\u6587\u5b57\u4f53\u652f\u6301\uff08\u53ef\u9009\uff0c\u6216\u4f7f\u7528 RegisterFont \u4ee3\u66ff\uff09\nRUN apt-get update && apt-get install -y fonts-noto-cjk && rm -rf \/var\/lib\/apt\/lists\/*\n\nFROM mcr.microsoft.com\/dotnet\/sdk:8.0 AS build\nWORKDIR \/src\nCOPY [\"MyApp.csproj\", \".\"]\nRUN dotnet restore\nCOPY . .\nRUN dotnet build -c Release -o \/app\/build\n\nFROM build AS publish\nRUN dotnet publish -c Release -o \/app\/publish\n\nFROM base AS final\nWORKDIR \/app\nCOPY --from=publish \/app\/publish .\n\n# \u590d\u5236\u81ea\u5b9a\u4e49\u5b57\u4f53\uff08\u63a8\u8350\u65b9\u5f0f\uff09\nCOPY Fonts\/ .\/Fonts\/\n\nENTRYPOINT [\"dotnet\", \"MyApp.dll\"]<\/code><\/pre>\n\n\n\n<\/span>
    9.2 \u4f7f\u7528\u5185\u5d4c\u5b57\u4f53\uff08\u63a8\u8350\u751f\u4ea7\u73af\u5883\uff09<\/h3>\n\n\n\n
    \u4e0d\u4f9d\u8d56\u7cfb\u7edf\u5b57\u4f53\uff0c\u5c06\u5b57\u4f53\u6587\u4ef6\u6253\u5305\u8fdb\u9879\u76ee\uff1a<\/p>\n\n\n\n
    \/\/ Program.cs<\/em>\nvar fontPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, \"Fonts\");\nif (Directory.Exists(fontPath))\n{\n    foreach (var fontFile in Directory.GetFiles(fontPath, \"*.ttf\"))\n    {\n        var fontName = Path.GetFileNameWithoutExtension(fontFile);\n        MiniPdf.RegisterFont(fontName, File.ReadAllBytes(fontFile));\n    }\n}\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n<\/span>
    10. \u529f\u80fd\u652f\u6301\u8bf4\u660e\u4e0e\u5c40\u9650\u6027<\/h2>\n\n\n\n<\/span>
    10.1 Excel (.xlsx) \u529f\u80fd\u652f\u6301\u77e9\u9635<\/h3>\n\n\n
    \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    \u529f\u80fd<\/th>\n\u652f\u6301\u72b6\u6001<\/th>\n\u5907\u6ce8<\/th>\n<\/tr>\n<\/thead>\n
    \u57fa\u7840\u6587\u672c\u5185\u5bb9<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u5b57\u4f53\uff08\u540d\u79f0\u3001\u5927\u5c0f\u3001\u7c97\u4f53\u3001\u659c\u4f53\uff09<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u5355\u5143\u683c\u80cc\u666f\u8272 \/ \u5b57\u4f53\u989c\u8272<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u6587\u672c\u5bf9\u9f50\uff08\u6c34\u5e73 \/ \u5782\u76f4\uff09<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u5408\u5e76\u5355\u5143\u683c<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u8fb9\u6846\u6837\u5f0f<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u5d4c\u5165\u56fe\u7247\uff08JPEG \/ PNG\uff09<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u6570\u5b57\u683c\u5f0f\u5316<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u591a\u5de5\u4f5c\u8868<\/td>\n\u2705 \u652f\u6301<\/td>\n\u6bcf\u4e2a Sheet \u5bf9\u5e94 PDF \u4e2d\u7684\u72ec\u7acb\u9875<\/td>\n<\/tr>\n
    \u56fe\u8868\uff08Charts\uff09<\/td>\n\u26a0\ufe0f \u90e8\u5206\u652f\u6301<\/td>\n\u6e32\u67d3\u4e3a\u7b80\u5316\u77e2\u91cf\u8fd1\u4f3c\uff0c\u590d\u6742\u56fe\u8868\u4fdd\u771f\u5ea6\u8f83\u4f4e<\/td>\n<\/tr>\n
    \u957f\u6587\u672c\u81ea\u52a8\u6362\u884c<\/td>\n\u274c \u5df2\u77e5\u7f3a\u9677<\/td>\n\u8d85\u51fa\u5217\u5bbd\u7684\u6587\u672c\u4f1a\u88ab\u622a\u65ad\uff0c\u5f85\u4fee\u590d<\/td>\n<\/tr>\n
    CJK \u5b57\u7b26\uff08\u4e2d\u65e5\u97e9\uff09<\/td>\n\u26a0\ufe0f \u90e8\u5206\u652f\u6301<\/td>\n\u53ef\u901a\u8fc7 RegisterFont \u89e3\u51b3\u95f4\u8ddd\u95ee\u9898<\/td>\n<\/tr>\n
    \u6570\u636e\u900f\u89c6\u8868<\/td>\n\u274c \u4e0d\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    VBA \u5b8f<\/td>\n\u274c \u4e0d\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n\n\n<\/span>
    10.2 Word (.docx) \u529f\u80fd\u652f\u6301\u77e9\u9635<\/h3>\n\n\n
    \n\n\n\n\n\n\n\n\n\n\n\n\n\n
    \u529f\u80fd<\/th>\n\u652f\u6301\u72b6\u6001<\/th>\n\u5907\u6ce8<\/th>\n<\/tr>\n<\/thead>\n
    \u57fa\u7840\u6bb5\u843d\u6587\u672c<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u5b57\u4f53\u6837\u5f0f\uff08\u7c97\u4f53\u3001\u659c\u4f53\u3001\u4e0b\u5212\u7ebf\uff09<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u6807\u9898\u4e0e\u5217\u8868<\/td>\n\u2705 \u5b8c\u5168\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u8868\u683c<\/td>\n\u2705 \u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u5d4c\u5165\u56fe\u7247<\/td>\n\u2705 \u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u590d\u6742\u6392\u7248\uff08\u591a\u680f\u3001\u6587\u672c\u6846\uff09<\/td>\n\u26a0\ufe0f \u6709\u9650\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u9875\u7709 \/ \u9875\u811a<\/td>\n\u26a0\ufe0f \u90e8\u5206\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u76ee\u5f55\uff08TOC\uff09<\/td>\n\u274c \u4e0d\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n
    \u4fee\u8ba2\u8bb0\u5f55<\/td>\n\u274c \u4e0d\u652f\u6301<\/td>\n\u00a0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n\n\n<\/span>
    10.3 \u4f7f\u7528\u5efa\u8bae<\/h3>\n\n\n\n
      \n
    1. \u5bf9\u4e8e\u7b80\u5355\u8868\u683c\u548c\u6587\u6863<\/strong>\uff1aMiniPdf \u6548\u679c\u4f18\u79c0\uff0c\u63a8\u8350\u76f4\u63a5\u4f7f\u7528\u3002<\/li>\n\n\n\n
    2. \u5bf9\u4e8e\u590d\u6742\u56fe\u8868<\/strong>\uff1a\u5efa\u8bae\u9884\u5148\u8bc4\u4f30\u8f6c\u6362\u6548\u679c\uff0c\u5fc5\u8981\u65f6\u8003\u8651\u9884\u5904\u7406\u6216\u66ff\u4ee3\u65b9\u6848\u3002<\/li>\n\n\n\n
    3. \u5bf9\u4e8e\u4e2d\u6587\u5185\u5bb9<\/strong>\uff1a\u5efa\u8bae\u5728 Linux\/Docker \u73af\u5883\u4e2d\u4f7f\u7528\u00a0RegisterFont<\/code>\u00a0\u6ce8\u518c Noto Sans CJK \u5b57\u4f53\u3002<\/li>\n\n\n\n
    4. \u5bf9\u4e8e\u8d85\u957f\u6587\u672c\u5355\u5143\u683c<\/strong>\uff1a\u5f53\u524d\u7248\u672c\u5b58\u5728\u622a\u65ad\u95ee\u9898\uff0c\u53ef\u5728\u751f\u6210 Excel \u65f6\u9884\u5148\u8bbe\u7f6e\u81ea\u52a8\u6362\u884c\u6216\u9002\u5f53\u7684\u5217\u5bbd\u3002<\/li>\n<\/ol>\n\n\n\n
      \n\n\n\n<\/span>
      11. \u6027\u80fd\u4e0e\u57fa\u51c6\u6d4b\u8bd5<\/h2>\n\n\n\n<\/span>
      11.1 \u5b98\u65b9\u6d4b\u8bd5\u7ed3\u679c<\/h3>\n\n\n\n
      \u7ecf\u8fc7 373 \u4e2a\u6d4b\u8bd5\u7528\u4f8b<\/strong>\uff08\u4e0e MiniExcel \/ Office 365 \u8f93\u51fa\u5bf9\u6bd4\uff09\u7684\u8bc4\u4f30\uff1a<\/p>\n\n\n
      \n\n\n\n\n\n\n\n\n
      \u6587\u6863\u7c7b\u578b<\/th>\n\u7528\u4f8b\u6570<\/th>\n\ud83d\udfe2 \u4f18\u79c0\uff08\u226590%\uff09<\/th>\n\ud83d\udfe1 \u53ef\u63a5\u53d7\uff0870%~90%\uff09<\/th>\n\ud83d\udd34 \u5f85\u6539\u8fdb\uff08<70%\uff09<\/th>\n\u5e73\u5747\u5206<\/th>\n<\/tr>\n<\/thead>\n
      XLSX \u8f6c PDF<\/td>\n191<\/td>\n175<\/td>\n16<\/td>\n0<\/td>\n96.9%<\/strong><\/td>\n<\/tr>\n
      DOCX \u8f6c PDF<\/td>\n180<\/td>\n178<\/td>\n2<\/td>\n0<\/td>\n97.6%<\/strong><\/td>\n<\/tr>\n
      Issue \u6587\u4ef6<\/td>\n2<\/td>\n1<\/td>\n1<\/td>\n0<\/td>\n83.8%<\/td>\n<\/tr>\n
      \u5408\u8ba1<\/strong><\/td>\n373<\/strong><\/td>\n354<\/strong><\/td>\n19<\/strong><\/td>\n0<\/strong><\/td>\n97.2%<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n\n\n
      \n
      \u8bc4\u5206\u7ef4\u5ea6<\/strong>\uff1a\u6587\u672c\u76f8\u4f3c\u5ea6 40% + \u89c6\u89c9\u76f8\u4f3c\u5ea6 40% + \u9875\u6570 20%<\/p>\n<\/blockquote>\n\n\n\n<\/span>
      11.2 \u6027\u80fd\u7279\u70b9<\/h3>\n\n\n\n