@modern-js/module-tools-docs 2.2.0 → 2.2.1-beta.1

package/doc_build/static/js/async/zh_guide_basic_before-getting-started.js

@@ -0,0 +1,3711 @@
+"use strict";
+(self["webpackChunk_modern_js_module_tools_docs"] = self["webpackChunk_modern_js_module_tools_docs"] || []).push([["zh_guide_basic_before-getting-started"],{
+
+/***/ "./docs/zh/guide/basic/before-getting-started.md":
+/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   "CH": function() { return /* binding */ CH; },
+/* harmony export */   "chCodeConfig": function() { return /* binding */ chCodeConfig; },
+/* harmony export */   "content": function() { return /* binding */ content; },
+/* harmony export */   "frontmatter": function() { return /* binding */ frontmatter; },
+/* harmony export */   "title": function() { return /* binding */ title; },
+/* harmony export */   "toc": function() { return /* binding */ toc; }
+/* harmony export */ });
+/* harmony import */ var react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("../../node_modules/.pnpm/react@18.2.0/node_modules/react/jsx-runtime.js");
+/* harmony import */ var _code_hike_mdx_dist_components_cjs_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__("../../node_modules/.pnpm/@code-hike+mdx@0.7.4_react@18.2.0/node_modules/@code-hike/mdx/dist/components.esm.mjs");
+/*@jsxRuntime automatic @jsxImportSource react*/
+
+
+const CH = {
+  annotations: _code_hike_mdx_dist_components_cjs_js__WEBPACK_IMPORTED_MODULE_1__.annotations,
+  Code: _code_hike_mdx_dist_components_cjs_js__WEBPACK_IMPORTED_MODULE_1__.Code
+};
+const chCodeConfig = {
+  "staticMediaQuery": "not screen, (max-width: 768px)",
+  "theme": {
+    "name": "nord",
+    "type": "dark",
+    "semanticHighlighting": true,
+    "colors": {
+      "focusBorder": "#3b4252",
+      "foreground": "#d8dee9",
+      "activityBar.background": "#2e3440",
+      "activityBar.dropBackground": "#3b4252",
+      "activityBar.foreground": "#d8dee9",
+      "activityBar.activeBorder": "#88c0d0",
+      "activityBar.activeBackground": "#3b4252",
+      "activityBarBadge.background": "#88c0d0",
+      "activityBarBadge.foreground": "#2e3440",
+      "badge.foreground": "#2e3440",
+      "badge.background": "#88c0d0",
+      "button.background": "#88c0d0ee",
+      "button.foreground": "#2e3440",
+      "button.hoverBackground": "#88c0d0",
+      "button.secondaryBackground": "#434c5e",
+      "button.secondaryForeground": "#d8dee9",
+      "button.secondaryHoverBackground": "#4c566a",
+      "charts.red": "#bf616a",
+      "charts.blue": "#81a1c1",
+      "charts.yellow": "#ebcb8b",
+      "charts.orange": "#d08770",
+      "charts.green": "#a3be8c",
+      "charts.purple": "#b48ead",
+      "charts.foreground": "#d8dee9",
+      "charts.lines": "#88c0d0",
+      "debugConsole.infoForeground": "#88c0d0",
+      "debugConsole.warningForeground": "#ebcb8b",
+      "debugConsole.errorForeground": "#bf616a",
+      "debugConsole.sourceForeground": "#616e88",
+      "debugConsoleInputIcon.foreground": "#81a1c1",
+      "debugExceptionWidget.background": "#4c566a",
+      "debugExceptionWidget.border": "#2e3440",
+      "debugToolBar.background": "#3b4252",
+      "descriptionForeground": "#d8dee9e6",
+      "diffEditor.insertedTextBackground": "#81a1c133",
+      "diffEditor.removedTextBackground": "#bf616a4d",
+      "dropdown.background": "#3b4252",
+      "dropdown.border": "#3b4252",
+      "dropdown.foreground": "#d8dee9",
+      "editorActiveLineNumber.foreground": "#d8dee9cc",
+      "editorCursor.foreground": "#d8dee9",
+      "editorHint.border": "#ebcb8b00",
+      "editorHint.foreground": "#ebcb8b",
+      "editorIndentGuide.background": "#434c5eb3",
+      "editorIndentGuide.activeBackground": "#4c566a",
+      "editorInlayHint.background": "#434c5e",
+      "editorInlayHint.foreground": "#d8dee9",
+      "editorLineNumber.foreground": "#4c566a",
+      "editorLineNumber.activeForeground": "#d8dee9",
+      "editorWhitespace.foreground": "#4c566ab3",
+      "editorWidget.background": "#2e3440",
+      "editorWidget.border": "#3b4252",
+      "editor.background": "#2e3440",
+      "editor.foreground": "#d8dee9",
+      "editor.hoverHighlightBackground": "#3b4252",
+      "editor.findMatchBackground": "#88c0d066",
+      "editor.findMatchHighlightBackground": "#88c0d033",
+      "editor.findRangeHighlightBackground": "#88c0d033",
+      "editor.lineHighlightBackground": "#3b4252",
+      "editor.lineHighlightBorder": "#3b4252",
+      "editor.inactiveSelectionBackground": "#434c5ecc",
+      "editor.inlineValuesBackground": "#4c566a",
+      "editor.inlineValuesForeground": "#eceff4",
+      "editor.selectionBackground": "#434c5ecc",
+      "editor.selectionHighlightBackground": "#434c5ecc",
+      "editor.rangeHighlightBackground": "#434c5e52",
+      "editor.wordHighlightBackground": "#81a1c166",
+      "editor.wordHighlightStrongBackground": "#81a1c199",
+      "editor.stackFrameHighlightBackground": "#5e81ac",
+      "editor.focusedStackFrameHighlightBackground": "#5e81ac",
+      "editorError.foreground": "#bf616a",
+      "editorError.border": "#bf616a00",
+      "editorWarning.foreground": "#ebcb8b",
+      "editorWarning.border": "#ebcb8b00",
+      "editorBracketMatch.background": "#2e344000",
+      "editorBracketMatch.border": "#88c0d0",
+      "editorBracketHighlight.foreground1": "#8fbcbb",
+      "editorBracketHighlight.foreground2": "#88c0d0",
+      "editorBracketHighlight.foreground3": "#81a1c1",
+      "editorBracketHighlight.foreground4": "#5e81ac",
+      "editorBracketHighlight.foreground5": "#8fbcbb",
+      "editorBracketHighlight.foreground6": "#88c0d0",
+      "editorBracketHighlight.unexpectedBracket.foreground": "#bf616a",
+      "editorCodeLens.foreground": "#4c566a",
+      "editorGroup.background": "#2e3440",
+      "editorGroup.border": "#3b425201",
+      "editorGroup.dropBackground": "#3b425299",
+      "editorGroupHeader.border": "#3b425200",
+      "editorGroupHeader.noTabsBackground": "#2e3440",
+      "editorGroupHeader.tabsBackground": "#2e3440",
+      "editorGroupHeader.tabsBorder": "#3b425200",
+      "editorGutter.background": "#2e3440",
+      "editorGutter.modifiedBackground": "#ebcb8b",
+      "editorGutter.addedBackground": "#a3be8c",
+      "editorGutter.deletedBackground": "#bf616a",
+      "editorHoverWidget.background": "#3b4252",
+      "editorHoverWidget.border": "#3b4252",
+      "editorLink.activeForeground": "#88c0d0",
+      "editorMarkerNavigation.background": "#5e81acc0",
+      "editorMarkerNavigationError.background": "#bf616ac0",
+      "editorMarkerNavigationWarning.background": "#ebcb8bc0",
+      "editorOverviewRuler.border": "#3b4252",
+      "editorOverviewRuler.currentContentForeground": "#3b4252",
+      "editorOverviewRuler.incomingContentForeground": "#3b4252",
+      "editorOverviewRuler.findMatchForeground": "#88c0d066",
+      "editorOverviewRuler.rangeHighlightForeground": "#88c0d066",
+      "editorOverviewRuler.selectionHighlightForeground": "#88c0d066",
+      "editorOverviewRuler.wordHighlightForeground": "#88c0d066",
+      "editorOverviewRuler.wordHighlightStrongForeground": "#88c0d066",
+      "editorOverviewRuler.modifiedForeground": "#ebcb8b",
+      "editorOverviewRuler.addedForeground": "#a3be8c",
+      "editorOverviewRuler.deletedForeground": "#bf616a",
+      "editorOverviewRuler.errorForeground": "#bf616a",
+      "editorOverviewRuler.warningForeground": "#ebcb8b",
+      "editorOverviewRuler.infoForeground": "#81a1c1",
+      "editorRuler.foreground": "#434c5e",
+      "editorSuggestWidget.background": "#2e3440",
+      "editorSuggestWidget.border": "#3b4252",
+      "editorSuggestWidget.foreground": "#d8dee9",
+      "editorSuggestWidget.focusHighlightForeground": "#88c0d0",
+      "editorSuggestWidget.highlightForeground": "#88c0d0",
+      "editorSuggestWidget.selectedBackground": "#434c5e",
+      "editorSuggestWidget.selectedForeground": "#d8dee9",
+      "extensionButton.prominentForeground": "#d8dee9",
+      "extensionButton.prominentBackground": "#434c5e",
+      "extensionButton.prominentHoverBackground": "#4c566a",
+      "errorForeground": "#bf616a",
+      "gitDecoration.modifiedResourceForeground": "#ebcb8b",
+      "gitDecoration.deletedResourceForeground": "#bf616a",
+      "gitDecoration.untrackedResourceForeground": "#a3be8c",
+      "gitDecoration.ignoredResourceForeground": "#d8dee966",
+      "gitDecoration.conflictingResourceForeground": "#5e81ac",
+      "gitDecoration.submoduleResourceForeground": "#8fbcbb",
+      "gitDecoration.stageDeletedResourceForeground": "#bf616a",
+      "gitDecoration.stageModifiedResourceForeground": "#ebcb8b",
+      "input.background": "#3b4252",
+      "input.foreground": "#d8dee9",
+      "input.placeholderForeground": "#d8dee999",
+      "input.border": "#3b4252",
+      "inputOption.activeBackground": "#5e81ac",
+      "inputOption.activeBorder": "#5e81ac",
+      "inputOption.activeForeground": "#eceff4",
+      "inputValidation.errorBackground": "#bf616a",
+      "inputValidation.errorBorder": "#bf616a",
+      "inputValidation.infoBackground": "#81a1c1",
+      "inputValidation.infoBorder": "#81a1c1",
+      "inputValidation.warningBackground": "#d08770",
+      "inputValidation.warningBorder": "#d08770",
+      "keybindingLabel.background": "#4c566a",
+      "keybindingLabel.border": "#4c566a",
+      "keybindingLabel.bottomBorder": "#4c566a",
+      "keybindingLabel.foreground": "#d8dee9",
+      "list.activeSelectionBackground": "#88c0d0",
+      "list.activeSelectionForeground": "#2e3440",
+      "list.inactiveSelectionBackground": "#434c5e",
+      "list.inactiveSelectionForeground": "#d8dee9",
+      "list.inactiveFocusBackground": "#434c5ecc",
+      "list.hoverForeground": "#eceff4",
+      "list.focusForeground": "#d8dee9",
+      "list.focusBackground": "#88c0d099",
+      "list.focusHighlightForeground": "#eceff4",
+      "list.hoverBackground": "#3b4252",
+      "list.dropBackground": "#88c0d099",
+      "list.highlightForeground": "#88c0d0",
+      "list.errorForeground": "#bf616a",
+      "list.warningForeground": "#ebcb8b",
+      "merge.currentHeaderBackground": "#81a1c166",
+      "merge.currentContentBackground": "#81a1c14d",
+      "merge.incomingHeaderBackground": "#8fbcbb66",
+      "merge.incomingContentBackground": "#8fbcbb4d",
+      "merge.border": "#3b425200",
+      "minimap.background": "#2e3440",
+      "minimap.errorHighlight": "#bf616acc",
+      "minimap.findMatchHighlight": "#88c0d0",
+      "minimap.selectionHighlight": "#88c0d0cc",
+      "minimap.warningHighlight": "#ebcb8bcc",
+      "minimapGutter.addedBackground": "#a3be8c",
+      "minimapGutter.deletedBackground": "#bf616a",
+      "minimapGutter.modifiedBackground": "#ebcb8b",
+      "minimapSlider.activeBackground": "#434c5eaa",
+      "minimapSlider.background": "#434c5e99",
+      "minimapSlider.hoverBackground": "#434c5eaa",
+      "notification.background": "#3b4252",
+      "notification.buttonBackground": "#434c5e",
+      "notification.buttonForeground": "#d8dee9",
+      "notification.buttonHoverBackground": "#4c566a",
+      "notification.errorBackground": "#bf616a",
+      "notification.errorForeground": "#2e3440",
+      "notification.foreground": "#d8dee9",
+      "notification.infoBackground": "#88c0d0",
+      "notification.infoForeground": "#2e3440",
+      "notification.warningBackground": "#ebcb8b",
+      "notification.warningForeground": "#2e3440",
+      "notificationCenter.border": "#3b425200",
+      "notificationCenterHeader.background": "#2e3440",
+      "notificationCenterHeader.foreground": "#88c0d0",
+      "notificationLink.foreground": "#88c0d0",
+      "notifications.background": "#3b4252",
+      "notifications.border": "#2e3440",
+      "notifications.foreground": "#d8dee9",
+      "notificationToast.border": "#3b425200",
+      "panel.background": "#2e3440",
+      "panel.border": "#3b4252",
+      "panelTitle.activeBorder": "#88c0d000",
+      "panelTitle.activeForeground": "#88c0d0",
+      "panelTitle.inactiveForeground": "#d8dee9",
+      "peekView.border": "#4c566a",
+      "peekViewEditor.background": "#2e3440",
+      "peekViewEditorGutter.background": "#2e3440",
+      "peekViewEditor.matchHighlightBackground": "#88c0d04d",
+      "peekViewResult.background": "#2e3440",
+      "peekViewResult.fileForeground": "#88c0d0",
+      "peekViewResult.lineForeground": "#d8dee966",
+      "peekViewResult.matchHighlightBackground": "#88c0d0cc",
+      "peekViewResult.selectionBackground": "#434c5e",
+      "peekViewResult.selectionForeground": "#d8dee9",
+      "peekViewTitle.background": "#3b4252",
+      "peekViewTitleDescription.foreground": "#d8dee9",
+      "peekViewTitleLabel.foreground": "#88c0d0",
+      "pickerGroup.border": "#3b4252",
+      "pickerGroup.foreground": "#88c0d0",
+      "progressBar.background": "#88c0d0",
+      "quickInputList.focusBackground": "#88c0d0",
+      "quickInputList.focusForeground": "#2e3440",
+      "sash.hoverBorder": "#88c0d0",
+      "scrollbar.shadow": "#00000066",
+      "scrollbarSlider.activeBackground": "#434c5eaa",
+      "scrollbarSlider.background": "#434c5e99",
+      "scrollbarSlider.hoverBackground": "#434c5eaa",
+      "selection.background": "#88c0d099",
+      "sideBar.background": "#2e3440",
+      "sideBar.foreground": "#d8dee9",
+      "sideBar.border": "#3b4252",
+      "sideBarSectionHeader.background": "#3b4252",
+      "sideBarSectionHeader.foreground": "#d8dee9",
+      "sideBarTitle.foreground": "#d8dee9",
+      "statusBar.background": "#3b4252",
+      "statusBar.debuggingBackground": "#5e81ac",
+      "statusBar.debuggingForeground": "#d8dee9",
+      "statusBar.noFolderForeground": "#d8dee9",
+      "statusBar.noFolderBackground": "#3b4252",
+      "statusBar.foreground": "#d8dee9",
+      "statusBarItem.activeBackground": "#4c566a",
+      "statusBarItem.hoverBackground": "#434c5e",
+      "statusBarItem.prominentBackground": "#3b4252",
+      "statusBarItem.prominentHoverBackground": "#434c5e",
+      "statusBarItem.errorBackground": "#3b4252",
+      "statusBarItem.errorForeground": "#bf616a",
+      "statusBarItem.warningBackground": "#ebcb8b",
+      "statusBarItem.warningForeground": "#2e3440",
+      "statusBar.border": "#3b425200",
+      "tab.activeBackground": "#3b4252",
+      "tab.activeForeground": "#d8dee9",
+      "tab.border": "#3b425200",
+      "tab.activeBorder": "#88c0d000",
+      "tab.unfocusedActiveBorder": "#88c0d000",
+      "tab.inactiveBackground": "#2e3440",
+      "tab.inactiveForeground": "#d8dee966",
+      "tab.unfocusedActiveForeground": "#d8dee999",
+      "tab.unfocusedInactiveForeground": "#d8dee966",
+      "tab.hoverBackground": "#3b4252cc",
+      "tab.unfocusedHoverBackground": "#3b4252b3",
+      "tab.hoverBorder": "#88c0d000",
+      "tab.unfocusedHoverBorder": "#88c0d000",
+      "tab.activeBorderTop": "#88c0d000",
+      "tab.unfocusedActiveBorderTop": "#88c0d000",
+      "tab.lastPinnedBorder": "#4c566a",
+      "terminal.background": "#2e3440",
+      "terminal.foreground": "#d8dee9",
+      "terminal.ansiBlack": "#3b4252",
+      "terminal.ansiRed": "#bf616a",
+      "terminal.ansiGreen": "#a3be8c",
+      "terminal.ansiYellow": "#ebcb8b",
+      "terminal.ansiBlue": "#81a1c1",
+      "terminal.ansiMagenta": "#b48ead",
+      "terminal.ansiCyan": "#88c0d0",
+      "terminal.ansiWhite": "#e5e9f0",
+      "terminal.ansiBrightBlack": "#4c566a",
+      "terminal.ansiBrightRed": "#bf616a",
+      "terminal.ansiBrightGreen": "#a3be8c",
+      "terminal.ansiBrightYellow": "#ebcb8b",
+      "terminal.ansiBrightBlue": "#81a1c1",
+      "terminal.ansiBrightMagenta": "#b48ead",
+      "terminal.ansiBrightCyan": "#8fbcbb",
+      "terminal.ansiBrightWhite": "#eceff4",
+      "terminal.tab.activeBorder": "#88c0d0",
+      "textBlockQuote.background": "#3b4252",
+      "textBlockQuote.border": "#81a1c1",
+      "textCodeBlock.background": "#4c566a",
+      "textLink.activeForeground": "#88c0d0",
+      "textLink.foreground": "#88c0d0",
+      "textPreformat.foreground": "#8fbcbb",
+      "textSeparator.foreground": "#eceff4",
+      "titleBar.activeBackground": "#2e3440",
+      "titleBar.activeForeground": "#d8dee9",
+      "titleBar.border": "#2e344000",
+      "titleBar.inactiveBackground": "#2e3440",
+      "titleBar.inactiveForeground": "#d8dee966",
+      "tree.indentGuidesStroke": "#616e88",
+      "walkThrough.embeddedEditorBackground": "#2e3440",
+      "welcomePage.buttonBackground": "#434c5e",
+      "welcomePage.buttonHoverBackground": "#4c566a",
+      "widget.shadow": "#00000066"
+    },
+    "tokenColors": [{
+      "settings": {
+        "foreground": "#d8dee9ff",
+        "background": "#2e3440ff"
+      }
+    }, {
+      "scope": "emphasis",
+      "settings": {
+        "fontStyle": "italic"
+      }
+    }, {
+      "scope": "strong",
+      "settings": {
+        "fontStyle": "bold"
+      }
+    }, {
+      "name": "Comment",
+      "scope": "comment",
+      "settings": {
+        "foreground": "#616E88"
+      }
+    }, {
+      "name": "Constant Character",
+      "scope": "constant.character",
+      "settings": {
+        "foreground": "#EBCB8B"
+      }
+    }, {
+      "name": "Constant Character Escape",
+      "scope": "constant.character.escape",
+      "settings": {
+        "foreground": "#EBCB8B"
+      }
+    }, {
+      "name": "Constant Language",
+      "scope": "constant.language",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Constant Numeric",
+      "scope": "constant.numeric",
+      "settings": {
+        "foreground": "#B48EAD"
+      }
+    }, {
+      "name": "Constant Regexp",
+      "scope": "constant.regexp",
+      "settings": {
+        "foreground": "#EBCB8B"
+      }
+    }, {
+      "name": "Entity Name Class/Type",
+      "scope": ["entity.name.class", "entity.name.type.class"],
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "Entity Name Function",
+      "scope": "entity.name.function",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "Entity Name Tag",
+      "scope": "entity.name.tag",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Entity Other Attribute Name",
+      "scope": "entity.other.attribute-name",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "Entity Other Inherited Class",
+      "scope": "entity.other.inherited-class",
+      "settings": {
+        "fontStyle": "bold",
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "Invalid Deprecated",
+      "scope": "invalid.deprecated",
+      "settings": {
+        "foreground": "#D8DEE9",
+        "background": "#EBCB8B"
+      }
+    }, {
+      "name": "Invalid Illegal",
+      "scope": "invalid.illegal",
+      "settings": {
+        "foreground": "#D8DEE9",
+        "background": "#BF616A"
+      }
+    }, {
+      "name": "Keyword",
+      "scope": "keyword",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Keyword Operator",
+      "scope": "keyword.operator",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Keyword Other New",
+      "scope": "keyword.other.new",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Markup Bold",
+      "scope": "markup.bold",
+      "settings": {
+        "fontStyle": "bold"
+      }
+    }, {
+      "name": "Markup Changed",
+      "scope": "markup.changed",
+      "settings": {
+        "foreground": "#EBCB8B"
+      }
+    }, {
+      "name": "Markup Deleted",
+      "scope": "markup.deleted",
+      "settings": {
+        "foreground": "#BF616A"
+      }
+    }, {
+      "name": "Markup Inserted",
+      "scope": "markup.inserted",
+      "settings": {
+        "foreground": "#A3BE8C"
+      }
+    }, {
+      "name": "Meta Preprocessor",
+      "scope": "meta.preprocessor",
+      "settings": {
+        "foreground": "#5E81AC"
+      }
+    }, {
+      "name": "Punctuation",
+      "scope": "punctuation",
+      "settings": {
+        "foreground": "#ECEFF4"
+      }
+    }, {
+      "name": "Punctuation Definition Parameters",
+      "scope": ["punctuation.definition.method-parameters", "punctuation.definition.function-parameters", "punctuation.definition.parameters"],
+      "settings": {
+        "foreground": "#ECEFF4"
+      }
+    }, {
+      "name": "Punctuation Definition Tag",
+      "scope": "punctuation.definition.tag",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Punctuation Definition Comment",
+      "scope": ["punctuation.definition.comment", "punctuation.end.definition.comment", "punctuation.start.definition.comment"],
+      "settings": {
+        "foreground": "#616E88"
+      }
+    }, {
+      "name": "Punctuation Section",
+      "scope": "punctuation.section",
+      "settings": {
+        "foreground": "#ECEFF4"
+      }
+    }, {
+      "name": "Punctuation Section Embedded",
+      "scope": ["punctuation.section.embedded.begin", "punctuation.section.embedded.end"],
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Punctuation Terminator",
+      "scope": "punctuation.terminator",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Punctuation Variable",
+      "scope": "punctuation.definition.variable",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Storage",
+      "scope": "storage",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "String",
+      "scope": "string",
+      "settings": {
+        "foreground": "#A3BE8C"
+      }
+    }, {
+      "name": "String Regexp",
+      "scope": "string.regexp",
+      "settings": {
+        "foreground": "#EBCB8B"
+      }
+    }, {
+      "name": "Support Class",
+      "scope": "support.class",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "Support Constant",
+      "scope": "support.constant",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Support Function",
+      "scope": "support.function",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "Support Function Construct",
+      "scope": "support.function.construct",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Support Type",
+      "scope": "support.type",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "Support Type Exception",
+      "scope": "support.type.exception",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "Token Debug",
+      "scope": "token.debug-token",
+      "settings": {
+        "foreground": "#b48ead"
+      }
+    }, {
+      "name": "Token Error",
+      "scope": "token.error-token",
+      "settings": {
+        "foreground": "#bf616a"
+      }
+    }, {
+      "name": "Token Info",
+      "scope": "token.info-token",
+      "settings": {
+        "foreground": "#88c0d0"
+      }
+    }, {
+      "name": "Token Warning",
+      "scope": "token.warn-token",
+      "settings": {
+        "foreground": "#ebcb8b"
+      }
+    }, {
+      "name": "Variable",
+      "scope": "variable.other",
+      "settings": {
+        "foreground": "#D8DEE9"
+      }
+    }, {
+      "name": "Variable Language",
+      "scope": "variable.language",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "Variable Parameter",
+      "scope": "variable.parameter",
+      "settings": {
+        "foreground": "#D8DEE9"
+      }
+    }, {
+      "name": "[C/CPP] Punctuation Separator Pointer-Access",
+      "scope": "punctuation.separator.pointer-access.c",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[C/CPP] Meta Preprocessor Include",
+      "scope": ["source.c meta.preprocessor.include", "source.c string.quoted.other.lt-gt.include"],
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[C/CPP] Conditional Directive",
+      "scope": ["source.cpp keyword.control.directive.conditional", "source.cpp punctuation.definition.directive", "source.c keyword.control.directive.conditional", "source.c punctuation.definition.directive"],
+      "settings": {
+        "foreground": "#5E81AC",
+        "fontStyle": "bold"
+      }
+    }, {
+      "name": "[CSS] Constant Other Color RGB Value",
+      "scope": "source.css constant.other.color.rgb-value",
+      "settings": {
+        "foreground": "#B48EAD"
+      }
+    }, {
+      "name": "[CSS](Function) Meta Property-Value",
+      "scope": "source.css meta.property-value",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[CSS] Media Queries",
+      "scope": ["source.css keyword.control.at-rule.media", "source.css keyword.control.at-rule.media punctuation.definition.keyword"],
+      "settings": {
+        "foreground": "#D08770"
+      }
+    }, {
+      "name": "[CSS] Punctuation Definition Keyword",
+      "scope": "source.css punctuation.definition.keyword",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[CSS] Support Type Property Name",
+      "scope": "source.css support.type.property-name",
+      "settings": {
+        "foreground": "#D8DEE9"
+      }
+    }, {
+      "name": "[diff] Meta Range Context",
+      "scope": "source.diff meta.diff.range.context",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[diff] Meta Header From-File",
+      "scope": "source.diff meta.diff.header.from-file",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[diff] Punctuation Definition From-File",
+      "scope": "source.diff punctuation.definition.from-file",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[diff] Punctuation Definition Range",
+      "scope": "source.diff punctuation.definition.range",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[diff] Punctuation Definition Separator",
+      "scope": "source.diff punctuation.definition.separator",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[Elixir](JakeBecker.elixir-ls) module names",
+      "scope": "entity.name.type.module.elixir",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Elixir](JakeBecker.elixir-ls) module attributes",
+      "scope": "variable.other.readwrite.module.elixir",
+      "settings": {
+        "foreground": "#D8DEE9",
+        "fontStyle": "bold"
+      }
+    }, {
+      "name": "[Elixir](JakeBecker.elixir-ls) atoms",
+      "scope": "constant.other.symbol.elixir",
+      "settings": {
+        "foreground": "#D8DEE9",
+        "fontStyle": "bold"
+      }
+    }, {
+      "name": "[Elixir](JakeBecker.elixir-ls) modules",
+      "scope": "variable.other.constant.elixir",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Go] String Format Placeholder",
+      "scope": "source.go constant.other.placeholder.go",
+      "settings": {
+        "foreground": "#EBCB8B"
+      }
+    }, {
+      "name": "[Java](JavaDoc) Comment Block Documentation HTML Entities",
+      "scope": "source.java comment.block.documentation.javadoc punctuation.definition.entity.html",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[Java](JavaDoc) Constant Other",
+      "scope": "source.java constant.other",
+      "settings": {
+        "foreground": "#D8DEE9"
+      }
+    }, {
+      "name": "[Java](JavaDoc) Keyword Other Documentation",
+      "scope": "source.java keyword.other.documentation",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Java](JavaDoc) Keyword Other Documentation Author",
+      "scope": "source.java keyword.other.documentation.author.javadoc",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Java](JavaDoc) Keyword Other Documentation Directive/Custom",
+      "scope": ["source.java keyword.other.documentation.directive", "source.java keyword.other.documentation.custom"],
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Java](JavaDoc) Keyword Other Documentation See",
+      "scope": "source.java keyword.other.documentation.see.javadoc",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Java] Meta Method-Call",
+      "scope": "source.java meta.method-call meta.method",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[Java](JavaDoc) Meta Tag Template Link",
+      "scope": ["source.java meta.tag.template.link.javadoc", "source.java string.other.link.title.javadoc"],
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Java](JavaDoc) Meta Tag Template Value",
+      "scope": "source.java meta.tag.template.value.javadoc",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[Java](JavaDoc) Punctuation Definition Keyword",
+      "scope": "source.java punctuation.definition.keyword.javadoc",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Java](JavaDoc) Punctuation Definition Tag",
+      "scope": ["source.java punctuation.definition.tag.begin.javadoc", "source.java punctuation.definition.tag.end.javadoc"],
+      "settings": {
+        "foreground": "#616E88"
+      }
+    }, {
+      "name": "[Java] Storage Modifier Import",
+      "scope": "source.java storage.modifier.import",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Java] Storage Modifier Package",
+      "scope": "source.java storage.modifier.package",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Java] Storage Type",
+      "scope": "source.java storage.type",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Java] Storage Type Annotation",
+      "scope": "source.java storage.type.annotation",
+      "settings": {
+        "foreground": "#D08770"
+      }
+    }, {
+      "name": "[Java] Storage Type Generic",
+      "scope": "source.java storage.type.generic",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Java] Storage Type Primitive",
+      "scope": "source.java storage.type.primitive",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[JavaScript] Decorator",
+      "scope": ["source.js punctuation.decorator", "source.js meta.decorator variable.other.readwrite", "source.js meta.decorator entity.name.function"],
+      "settings": {
+        "foreground": "#D08770"
+      }
+    }, {
+      "name": "[JavaScript] Meta Object-Literal Key",
+      "scope": "source.js meta.object-literal.key",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[JavaScript](JSDoc) Storage Type Class",
+      "scope": "source.js storage.type.class.jsdoc",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[JavaScript] String Template Literals Punctuation",
+      "scope": ["source.js string.quoted.template punctuation.quasi.element.begin", "source.js string.quoted.template punctuation.quasi.element.end", "source.js string.template punctuation.definition.template-expression"],
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[JavaScript] Interpolated String Template Punctuation Functions",
+      "scope": "source.js string.quoted.template meta.method-call.with-arguments",
+      "settings": {
+        "foreground": "#ECEFF4"
+      }
+    }, {
+      "name": "[JavaScript] String Template Literal Variable",
+      "scope": ["source.js string.template meta.template.expression support.variable.property", "source.js string.template meta.template.expression variable.other.object"],
+      "settings": {
+        "foreground": "#D8DEE9"
+      }
+    }, {
+      "name": "[JavaScript] Support Type Primitive",
+      "scope": "source.js support.type.primitive",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[JavaScript] Variable Other Object",
+      "scope": "source.js variable.other.object",
+      "settings": {
+        "foreground": "#D8DEE9"
+      }
+    }, {
+      "name": "[JavaScript] Variable Other Read-Write Alias",
+      "scope": "source.js variable.other.readwrite.alias",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[JavaScript] Parentheses in Template Strings",
+      "scope": ["source.js meta.embedded.line meta.brace.square", "source.js meta.embedded.line meta.brace.round", "source.js string.quoted.template meta.brace.square", "source.js string.quoted.template meta.brace.round"],
+      "settings": {
+        "foreground": "#ECEFF4"
+      }
+    }, {
+      "name": "[HTML] Constant Character Entity",
+      "scope": "text.html.basic constant.character.entity.html",
+      "settings": {
+        "foreground": "#EBCB8B"
+      }
+    }, {
+      "name": "[HTML] Constant Other Inline-Data",
+      "scope": "text.html.basic constant.other.inline-data",
+      "settings": {
+        "foreground": "#D08770",
+        "fontStyle": "italic"
+      }
+    }, {
+      "name": "[HTML] Meta Tag SGML Doctype",
+      "scope": "text.html.basic meta.tag.sgml.doctype",
+      "settings": {
+        "foreground": "#5E81AC"
+      }
+    }, {
+      "name": "[HTML] Punctuation Definition Entity",
+      "scope": "text.html.basic punctuation.definition.entity",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[INI] Entity Name Section Group-Title",
+      "scope": "source.properties entity.name.section.group-title.ini",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[INI] Punctuation Separator Key-Value",
+      "scope": "source.properties punctuation.separator.key-value.ini",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[Markdown] Markup Fenced Code Block",
+      "scope": ["text.html.markdown markup.fenced_code.block", "text.html.markdown markup.fenced_code.block punctuation.definition"],
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Markdown] Markup Heading",
+      "scope": "markup.heading",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[Markdown] Markup Inline",
+      "scope": ["text.html.markdown markup.inline.raw", "text.html.markdown markup.inline.raw punctuation.definition.raw"],
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Markdown] Markup Italic",
+      "scope": "text.html.markdown markup.italic",
+      "settings": {
+        "fontStyle": "italic"
+      }
+    }, {
+      "name": "[Markdown] Markup Link",
+      "scope": "text.html.markdown markup.underline.link",
+      "settings": {
+        "fontStyle": "underline"
+      }
+    }, {
+      "name": "[Markdown] Markup List Numbered/Unnumbered",
+      "scope": "text.html.markdown beginning.punctuation.definition.list",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[Markdown] Markup Quote Punctuation Definition",
+      "scope": "text.html.markdown beginning.punctuation.definition.quote",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Markdown] Markup Quote Punctuation Definition",
+      "scope": "text.html.markdown markup.quote",
+      "settings": {
+        "foreground": "#616E88"
+      }
+    }, {
+      "name": "[Markdown] Markup Math Constant",
+      "scope": "text.html.markdown constant.character.math.tex",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[Markdown] Markup Math Definition Marker",
+      "scope": ["text.html.markdown punctuation.definition.math.begin", "text.html.markdown punctuation.definition.math.end"],
+      "settings": {
+        "foreground": "#5E81AC"
+      }
+    }, {
+      "name": "[Markdown] Markup Math Function Definition Marker",
+      "scope": "text.html.markdown punctuation.definition.function.math.tex",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[Markdown] Markup Math Operator",
+      "scope": "text.html.markdown punctuation.math.operator.latex",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[Markdown] Punctuation Definition Heading",
+      "scope": "text.html.markdown punctuation.definition.heading",
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[Markdown] Punctuation Definition Constant/String",
+      "scope": ["text.html.markdown punctuation.definition.constant", "text.html.markdown punctuation.definition.string"],
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[Markdown] String Other Link Description/Title",
+      "scope": ["text.html.markdown constant.other.reference.link", "text.html.markdown string.other.link.description", "text.html.markdown string.other.link.title"],
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[Perl] Perl Sigils",
+      "scope": "source.perl punctuation.definition.variable",
+      "settings": {
+        "foreground": "#D8DEE9"
+      }
+    }, {
+      "name": "[PHP] Meta Function-Call Object",
+      "scope": ["source.php meta.function-call", "source.php meta.function-call.object"],
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[Python] Decorator",
+      "scope": ["source.python entity.name.function.decorator", "source.python meta.function.decorator support.type"],
+      "settings": {
+        "foreground": "#D08770"
+      }
+    }, {
+      "name": "[Python] Function Call",
+      "scope": "source.python meta.function-call.generic",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[Python] Support Type",
+      "scope": "source.python support.type",
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[Python] Function Parameter",
+      "scope": ["source.python variable.parameter.function.language"],
+      "settings": {
+        "foreground": "#D8DEE9"
+      }
+    }, {
+      "name": "[Python] Function Parameter Special",
+      "scope": ["source.python meta.function.parameters variable.parameter.function.language.special.self"],
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[Rust] Entity types",
+      "scope": "source.rust entity.name.type",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[Rust] Macro",
+      "scope": "source.rust meta.macro entity.name.function",
+      "settings": {
+        "fontStyle": "bold",
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[Rust] Attributes",
+      "scope": ["source.rust meta.attribute", "source.rust meta.attribute punctuation", "source.rust meta.attribute keyword.operator"],
+      "settings": {
+        "foreground": "#5E81AC"
+      }
+    }, {
+      "name": "[Rust] Traits",
+      "scope": "source.rust entity.name.type.trait",
+      "settings": {
+        "fontStyle": "bold"
+      }
+    }, {
+      "name": "[Rust] Interpolation Bracket Curly",
+      "scope": "source.rust punctuation.definition.interpolation",
+      "settings": {
+        "foreground": "#EBCB8B"
+      }
+    }, {
+      "name": "[SCSS] Punctuation Definition Interpolation Bracket Curly",
+      "scope": ["source.css.scss punctuation.definition.interpolation.begin.bracket.curly", "source.css.scss punctuation.definition.interpolation.end.bracket.curly"],
+      "settings": {
+        "foreground": "#81A1C1"
+      }
+    }, {
+      "name": "[SCSS] Variable Interpolation",
+      "scope": "source.css.scss variable.interpolation",
+      "settings": {
+        "foreground": "#D8DEE9",
+        "fontStyle": "italic"
+      }
+    }, {
+      "name": "[TypeScript] Decorators",
+      "scope": ["source.ts punctuation.decorator", "source.ts meta.decorator variable.other.readwrite", "source.ts meta.decorator entity.name.function", "source.tsx punctuation.decorator", "source.tsx meta.decorator variable.other.readwrite", "source.tsx meta.decorator entity.name.function"],
+      "settings": {
+        "foreground": "#D08770"
+      }
+    }, {
+      "name": "[TypeScript] Object-literal keys",
+      "scope": ["source.ts meta.object-literal.key", "source.tsx meta.object-literal.key"],
+      "settings": {
+        "foreground": "#D8DEE9"
+      }
+    }, {
+      "name": "[TypeScript] Object-literal functions",
+      "scope": ["source.ts meta.object-literal.key entity.name.function", "source.tsx meta.object-literal.key entity.name.function"],
+      "settings": {
+        "foreground": "#88C0D0"
+      }
+    }, {
+      "name": "[TypeScript] Type/Class",
+      "scope": ["source.ts support.class", "source.ts support.type", "source.ts entity.name.type", "source.ts entity.name.class", "source.tsx support.class", "source.tsx support.type", "source.tsx entity.name.type", "source.tsx entity.name.class"],
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[TypeScript] Static Class Support",
+      "scope": ["source.ts support.constant.math", "source.ts support.constant.dom", "source.ts support.constant.json", "source.tsx support.constant.math", "source.tsx support.constant.dom", "source.tsx support.constant.json"],
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[TypeScript] Variables",
+      "scope": ["source.ts support.variable", "source.tsx support.variable"],
+      "settings": {
+        "foreground": "#D8DEE9"
+      }
+    }, {
+      "name": "[TypeScript] Parentheses in Template Strings",
+      "scope": ["source.ts meta.embedded.line meta.brace.square", "source.ts meta.embedded.line meta.brace.round", "source.tsx meta.embedded.line meta.brace.square", "source.tsx meta.embedded.line meta.brace.round"],
+      "settings": {
+        "foreground": "#ECEFF4"
+      }
+    }, {
+      "name": "[XML] Entity Name Tag Namespace",
+      "scope": "text.xml entity.name.tag.namespace",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }, {
+      "name": "[XML] Keyword Other Doctype",
+      "scope": "text.xml keyword.other.doctype",
+      "settings": {
+        "foreground": "#5E81AC"
+      }
+    }, {
+      "name": "[XML] Meta Tag Preprocessor",
+      "scope": "text.xml meta.tag.preprocessor entity.name.tag",
+      "settings": {
+        "foreground": "#5E81AC"
+      }
+    }, {
+      "name": "[XML] Entity Name Tag Namespace",
+      "scope": ["text.xml string.unquoted.cdata", "text.xml string.unquoted.cdata punctuation.definition.string"],
+      "settings": {
+        "foreground": "#D08770",
+        "fontStyle": "italic"
+      }
+    }, {
+      "name": "[YAML] Entity Name Tag",
+      "scope": "source.yaml entity.name.tag",
+      "settings": {
+        "foreground": "#8FBCBB"
+      }
+    }]
+  },
+  "autoImport": true,
+  "showCopyButton": true,
+  "skipLanguages": [],
+  "filepath": "/Users/bytedance/github/targeral/modern-dev/website/module-tools/docs/zh/guide/basic/before-getting-started.md"
+};
+const frontmatter = {
+  "sidebar_position": 1
+};
+const toc = [{
+  "id": "环境准备",
+  "text": "环境准备",
+  "depth": 2
+}, {
+  "id": "初识-npm",
+  "text": "初识 npm",
+  "depth": 2
+}, {
+  "id": "npm-包类型项目",
+  "text": "npm 包类型项目",
+  "depth": 2
+}, {
+  "id": "使用第三方-npm-包",
+  "text": "使用第三方 npm 包",
+  "depth": 2
+}, {
+  "id": "还需要了解的-npm-零碎知识",
+  "text": "还需要了解的 npm 零碎知识",
+  "depth": 2
+}, {
+  "id": "npm-包的程序入口",
+  "text": "npm 包的程序入口",
+  "depth": 3
+}, {
+  "id": "scripts",
+  "text": "\"scripts\"",
+  "depth": 3
+}, {
+  "id": "npm-install",
+  "text": "npm install",
+  "depth": 4
+}, {
+  "id": "npm-publish",
+  "text": "npm publish",
+  "depth": 4
+}, {
+  "id": "peerdependencies",
+  "text": "peerDependencies",
+  "depth": 3
+}, {
+  "id": "npm-包管理器",
+  "text": "npm 包管理器",
+  "depth": 2
+}, {
+  "id": "module-tools-配置文件",
+  "text": "Module Tools 配置文件",
+  "depth": 2
+}];
+const title = `开始之前`;
+const content = "\"---\\nsidebar_position: 1\\n---\\n\\n# 开始之前\\n\\n## 环境准备\\n\\n为了使用 Modern.js 模块工程解决方案，首先需要 [NodeJS](https://nodejs.org/zh/)，我们推荐最新的[长期维护版本](https://github.com/nodejs/Release)，并确保 Node 版本大于等于 **14.18.0**。因为非稳定的 NodeJS 时常有一些 Bug，你可以使用 [nvm-windows](https://github.com/coreybutler/nvm-windows) 和 [nvm](https://github.com/nvm-sh/nvm)（Mac/linux）安装，这样你就可以方便地切换到不同的 NodeJS 版本，这些版本可能会用于不同的项目。\\n\\n## 初识 npm\\n\\n当 NodeJS 被安装后，你不仅可以在命令行中访问 `node` 可执行程序，同时你也可以执行 `npm` 命令。\\n\\nnpm 是 NodeJS 的标准软件包管理器。它一开始的用途是用于下载和管理 NodeJS 包的依赖关系，但后来它逐渐变成为一个用于前端 JavaScript 的工具。\\n\\n**如果你已经对 npm 和 npm 包的使用方式有所了解，那么可以直接跳到[【npm 包管理器】](/guide/basic/before-getting-started#npm-包管理器)部分。**\\n\\n## npm 包类型项目\\n\\n那么什么是 npm 包类型的项目呢？当我们在一个空的项目目录下执行 `npm init` 命令的时候，它会在当前目录下面创建一个文件名为 `package.json` 的 JSON 文件。在创建过程中，我们需要填写包括但不限于 npm 包的名称、版本号、描述等等内容，这些填写的内容都会在生成的 `package.json` 文件中找到：\\n\\n```json\\n{\\n  \\\"name\\\": \\\"npm-demo\\\",\\n  \\\"version\\\": \\\"1.0.0\\\",\\n  \\\"description\\\": \\\"\\\",\\n  \\\"main\\\": \\\"index.js\\\",\\n  \\\"scripts\\\": {\\n    \\\"test\\\": \\\"echo \\\\\\\"Error: no test specified\\\\\\\" && exit 1\\\"\\n  },\\n  \\\"author\\\": \\\"\\\",\\n  \\\"license\\\": \\\"ISC\\\"\\n}\\n```\\n\\n此时这个包含了初始化后的 `package.json` 文件的项目就是一个 npm 包类型的项目，你可以执行 `npm publish` 命令将这个项目发布到 [npm Registry](https://www.npmjs.com/)。\\n\\nnpm Registry 是一个 [npm 包存储的地方](https://docs.npmjs.com/about-the-public-npm-registry)，开发者们不仅可以将他们自己的 npm 包发布到 npm Registry，还可以通过 npm Registry 使用其他开发者发布的 npm 包。\\n\\n优质的 npm 包会有更多的人去使用，因为它不仅节省了很多代码实现的工作，同时也不容易让项目出现问题。\\n\\n## 使用第三方 npm 包\\n\\n当要为初始化的项目增加第三方的 npm 包的时候，我们可以把这一过程叫做“为项目安装依赖”或是“为项目增加依赖”。在增加依赖之前，首先我们要特别了解一件事情 —— **npm 依赖的软件包类型**：\\n\\n- `\\\"dependencies\\\"`：一种是你的应用程序在生产环境中需要的软件包。\\n- `\\\"devDependencies\\\"`：另一种是仅在本地开发和测试中需要的软件包。\\n  > 软件包可以理解为是第三方的 npm 包。\\n\\n你可以通过执行 `npm install npm-package-name` 或者 `npm add npm-package-name` 的方式来安装在**生产环境中需要的软件包**，或者也可以在 `package.json` 文件中手动的将需要安装的包和对应的[语义化版本](https://docs.npmjs.com/about-semantic-versioning)写在 `\\\"dependencies\\\"` 里，并执行 `npm install` 命令：\\n\\n```json\\n{\\n  \\\"name\\\": \\\"your-npm-project\\\",\\n  \\\"dependencies\\\": {\\n    \\\"npm-package-name\\\": \\\"0.1.0\\\"\\n  }\\n}\\n```\\n\\n同理，你也可以执行 `npm install npm-package-name --save-dev` 或 `npm add npm-package-name --save-dev` 的方式来安装**仅在本地开发和测试中需要的软件包**，或者也可以在 `package.json` 文件中手动的将需要安装的包和对应的[语义化版本](https://docs.npmjs.com/about-semantic-versioning)写在 `\\\"devDependencies\\\"` 里，并执行 `npm install` 命令：\\n\\n```json\\n{\\n  \\\"name\\\": \\\"your-npm-project\\\",\\n  \\\"devDependencies\\\": {\\n    \\\"npm-package-name\\\": \\\"0.1.0\\\"\\n  }\\n}\\n```\\n\\n**在安装或者使用第三方 npm 包的时候一定要确定它们的用途，以及通过区分它们的类型确定好它们应该放在 `\\\"dependencies\\\"` 还是 `\\\"devDependencies\\\"` 中。**\\n\\n:::tip\\n一般来说，需要在源代码中使用到的包都属于 `dependencies` 依赖。除非你通过打包的方式将依赖的代码输出到本地，那么这种情况可以将它作为 `devDependencies` 依赖。\\n:::\\n\\n## 还需要了解的 npm 零碎知识\\n\\n### npm 包的程序入口\\n\\n在 `package.json` 中存在一个 `\\\"main\\\"` 属性，它对应的值是一个模块 ID，或者更直观的说是一个 NodeJS 文件路径，它是你程序的主要入口。\\n\\n例如你的包名为 `foo`，并且用户安装了它，然后执行 `require(\\\"foo\\\")` 代码，那么 `foo` 这个 npm 包的 `\\\"main\\\"` 字段对应的文件将会被导出。\\n\\n**推荐在你的 npm 包里一定要设置 `\\\"main\\\"` 字段**。如果没有设置 `\\\"main\\\"`，则默认入口为包的根目录下的 `index.js` 文件。\\n\\n除了需要设置 `\\\"main\\\"` 属性以外，一般还会设置 `\\\"module\\\"` 属性。它与 `\\\"main\\\"` 属性的用途类似，它主要是用于在 webpack 场景下使用。webpack 在大多数情况下，会以 **\\\"module\\\" -> \\\"main\\\"** 这个顺序读取 npm 包的入口（文件）。\\n\\n> 想要了解关于 webpack 如何做这件事，可以查看这个[链接](https://webpack.js.org/configuration/resolve/#resolvemainfields)。\\n\\n### `\\\"scripts\\\"`\\n\\n`package.json` 文件的 `\\\"scripts\\\"` 属性支持一些内置的脚本和 npm 预设的生命周期事件，以及任意的脚本。\\n\\n这些都可以通过运行 `npm run-script <stage>` 或简称 `npm run <stage>` 来执行。\\n\\n名称匹配的[前置命令和后置命令](https://docs.npmjs.com/cli/v9/using-npm/scripts#pre--post-scripts)也会被运行（例如 `premyscript`、`myscript`、`postmyscript`）。\\n\\n```json\\n{\\n  \\\"scripts\\\": {\\n    \\\"premyscript\\\": \\\"\\\",\\n    \\\"myscript\\\": \\\"\\\",\\n    \\\"postmyscript\\\": \\\"\\\"\\n  }\\n}\\n```\\n\\n当执行 `npm run myscripts` 的时候，`premyscripts` 对应的脚本会在它之前执行，`postmyscripts` 对应的脚本会在它之后执行。\\n\\n来自依赖的脚本命令可以用 `npm explore <pkg> -- npm run <stage>` 运行。\\n\\n还有一些特殊的生命周期脚本（Life Scripts），只在某些情况下发生。这里介绍几个通常需要了解的情况。\\n\\n#### `npm install`\\n\\n当你运行 `npm install -g <pkg-name>` 时，以下脚本会运行。\\n\\n- `preinstall`\\n- `install`\\n- `postinstall`\\n- `prepublish`\\n- `preprepare`\\n- `prepare`\\n- `postprepare`\\n\\n如果你的软件包根目录有一个 `binding.gyp` 文件，而你没有定义 `install` 或 `preinstall` 脚本，那么 npm 将以 `node-gyp rebuild` 作为默认的 install 命令，使用 [node-gyp](https://github.com/nodejs/node-gyp) 进行编译。\\n\\n#### `npm publish`\\n\\n当发布项目的时候，执行该命令会触发以下脚本：\\n\\n- `prepublishOnly`\\n- `prepack`\\n- `prepare`\\n- `postpack`\\n- `publish`\\n- `postpublish`\\n\\n当以 [`--dry-run`](https://docs.npmjs.com/cli/v7/commands/npm-publish#dry-run) 模式运行的时候，`prepare` 对应的脚本将不会执行。\\n\\n### peerDependencies\\n\\n在某些情况下，你的 npm 项目与它的宿主工具或者库之间存在某种兼容关系（例如一个 webpack 插件项目和 webpack），同时你的 npm 项目不想将宿主作为必要的依赖，这个时候通常说明你的项目可能是这个宿主工具或者库的插件。你的 npm 项目会对宿主包的版本有一定的要求，因为只有在特定的版本下才会暴露出 npm 项目所需要的 API。\\n\\n关于更多 `peerDependencies` 的解释，可以通过下面的链接了解 npm、pnpm、Yarn 对于它的不同处理方式：\\n\\n- [npm 对 peerDependencies 的解释](https://docs.npmjs.com/cli/v9/configuring-npm/package-json#peerdependencies)\\n- [pnpm vs npm VS Yarn](https://pnpm.io/feature-comparison)\\n\\n## npm 包管理器\\n\\n除了 npm 这种标准的包管理器以外，目前主流的还有 **pnpm** 和 **Yarn**，它们都是不错的 npm cli 替代品。\\n\\n推荐使用 [pnpm](https://pnpm.io/installation) 来管理项目依赖，可以通过下面的方式安装它：\\n\\n```bash\\nnpm install -g pnpm\\n```\\n\\n## Module Tools 配置文件\\n\\n通过`@modern-js/create`创建的模块工程项目目录下提供了 Module Tools 的配置文件 —— `modern.config.(j|t)s`。但 `modern.config` 配置文件不是必须存在的。\\n\\n默认情况下，生成的配置文件的内容如下：\\n\\n```typescript\\n// modern.config.ts\\nimport moduleTools, { defineConfig } from '@modern-js/module-tools';\\n\\nexport default defineConfig({\\n  plugins: [moduleTools()],\\n  buildPreset: 'npm-library',\\n});\\n```\\n\\n**我们推荐使用 `defineConfig` 函数**，不过并不强制使用它。因此你也可以在配置文件中直接返回一个对象：\\n\\n```ts\\n// modern.config.ts\\nimport moduleTools from '@modern-js/module-tools';\\n\\nexport default {\\n  plugins: [moduleTools()],\\n  buildPreset: 'npm-library',\\n};\\n```\\n\"";
+function _createMdxContent(props) {
+  const _components = Object.assign({
+    h1: "h1",
+    a: "a",
+    h2: "h2",
+    p: "p",
+    strong: "strong",
+    code: "code",
+    ul: "ul",
+    li: "li",
+    blockquote: "blockquote",
+    div: "div",
+    h3: "h3",
+    h4: "h4"
+  }, props.components);
+  if (!CH) _missingMdxReference("CH", false, "23:1-35:4");
+  if (!CH.Code) _missingMdxReference("CH.Code", true, "23:1-35:4");
+  return (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.Fragment, {
+    children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h1, {
+      id: "开始之前",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#开始之前",
+        children: "#"
+      }), "开始之前"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h2, {
+      id: "环境准备",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#环境准备",
+        children: "#"
+      }), "环境准备"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["为了使用 Modern.js 模块工程解决方案，首先需要 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://nodejs.org/zh/",
+        target: "_blank",
+        rel: "nofollow",
+        children: "NodeJS"
+      }), "，我们推荐最新的", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://github.com/nodejs/Release",
+        target: "_blank",
+        rel: "nofollow",
+        children: "长期维护版本"
+      }), "，并确保 Node 版本大于等于 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.strong, {
+        children: "14.18.0"
+      }), "。因为非稳定的 NodeJS 时常有一些 Bug，你可以使用 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://github.com/coreybutler/nvm-windows",
+        target: "_blank",
+        rel: "nofollow",
+        children: "nvm-windows"
+      }), " 和 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://github.com/nvm-sh/nvm",
+        target: "_blank",
+        rel: "nofollow",
+        children: "nvm"
+      }), "（Mac/linux）安装，这样你就可以方便地切换到不同的 NodeJS 版本，这些版本可能会用于不同的项目。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h2, {
+      id: "初识-npm",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#初识-npm",
+        children: "#"
+      }), "初识 npm"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["当 NodeJS 被安装后，你不仅可以在命令行中访问 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "node"
+      }), " 可执行程序，同时你也可以执行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm"
+      }), " 命令。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.p, {
+      children: "npm 是 NodeJS 的标准软件包管理器。它一开始的用途是用于下载和管理 NodeJS 包的依赖关系，但后来它逐渐变成为一个用于前端 JavaScript 的工具。"
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.p, {
+      children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.strong, {
+        children: ["如果你已经对 npm 和 npm 包的使用方式有所了解，那么可以直接跳到", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+          href: "/module-tools/guide/basic/before-getting-started.html#npm-%E5%8C%85%E7%AE%A1%E7%90%86%E5%99%A8",
+          children: "【npm 包管理器】"
+        }), "部分。"]
+      })
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h2, {
+      id: "npm-包类型项目",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#npm-包类型项目",
+        children: "#"
+      }), "npm 包类型项目"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["那么什么是 npm 包类型的项目呢？当我们在一个空的项目目录下执行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm init"
+      }), " 命令的时候，它会在当前目录下面创建一个文件名为 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "package.json"
+      }), " 的 JSON 文件。在创建过程中，我们需要填写包括但不限于 npm 包的名称、版本号、描述等等内容，这些填写的内容都会在生成的 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "package.json"
+      }), " 文件中找到："]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(CH.Code, {
+      codeConfig: chCodeConfig,
+      northPanel: {
+        "tabs": [""],
+        "active": "",
+        "heightRatio": 1
+      },
+      files: [{
+        "name": "",
+        "focus": "",
+        "code": {
+          "lines": [{
+            "tokens": [{
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "name",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "npm-demo",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "version",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "1.0.0",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "description",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "main",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "index.js",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "scripts",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "    ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "test",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "echo ",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\\\"",
+              "props": {
+                "style": {
+                  "color": "#EBCB8B"
+                }
+              }
+            }, {
+              "content": "Error: no test specified",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\\\"",
+              "props": {
+                "style": {
+                  "color": "#EBCB8B"
+                }
+              }
+            }, {
+              "content": " && exit 1",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "},",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "author",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "license",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "ISC",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "}",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }],
+          "lang": "json"
+        },
+        "annotations": []
+      }]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["此时这个包含了初始化后的 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "package.json"
+      }), " 文件的项目就是一个 npm 包类型的项目，你可以执行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm publish"
+      }), " 命令将这个项目发布到 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://www.npmjs.com/",
+        target: "_blank",
+        rel: "nofollow",
+        children: "npm Registry"
+      }), "。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["npm Registry 是一个 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://docs.npmjs.com/about-the-public-npm-registry",
+        target: "_blank",
+        rel: "nofollow",
+        children: "npm 包存储的地方"
+      }), "，开发者们不仅可以将他们自己的 npm 包发布到 npm Registry，还可以通过 npm Registry 使用其他开发者发布的 npm 包。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.p, {
+      children: "优质的 npm 包会有更多的人去使用，因为它不仅节省了很多代码实现的工作，同时也不容易让项目出现问题。"
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h2, {
+      id: "使用第三方-npm-包",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#使用第三方-npm-包",
+        children: "#"
+      }), "使用第三方 npm 包"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["当要为初始化的项目增加第三方的 npm 包的时候，我们可以把这一过程叫做“为项目安装依赖”或是“为项目增加依赖”。在增加依赖之前，首先我们要特别了解一件事情 —— ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.strong, {
+        children: "npm 依赖的软件包类型"
+      }), "："]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.ul, {
+      children: ["\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.li, {
+        children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "\"dependencies\""
+        }), "：一种是你的应用程序在生产环境中需要的软件包。"]
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.li, {
+        children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "\"devDependencies\""
+        }), "：另一种是仅在本地开发和测试中需要的软件包。", "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.blockquote, {
+          children: ["\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.p, {
+            children: "软件包可以理解为是第三方的 npm 包。"
+          }), "\n"]
+        }), "\n"]
+      }), "\n"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["你可以通过执行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm install npm-package-name"
+      }), " 或者 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm add npm-package-name"
+      }), " 的方式来安装在", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.strong, {
+        children: "生产环境中需要的软件包"
+      }), "，或者也可以在 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "package.json"
+      }), " 文件中手动的将需要安装的包和对应的", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://docs.npmjs.com/about-semantic-versioning",
+        target: "_blank",
+        rel: "nofollow",
+        children: "语义化版本"
+      }), "写在 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "\"dependencies\""
+      }), " 里，并执行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm install"
+      }), " 命令："]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(CH.Code, {
+      codeConfig: chCodeConfig,
+      northPanel: {
+        "tabs": [""],
+        "active": "",
+        "heightRatio": 1
+      },
+      files: [{
+        "name": "",
+        "focus": "",
+        "code": {
+          "lines": [{
+            "tokens": [{
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "name",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "your-npm-project",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "dependencies",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "    ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "npm-package-name",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "0.1.0",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "}",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "}",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }],
+          "lang": "json"
+        },
+        "annotations": []
+      }]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["同理，你也可以执行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm install npm-package-name --save-dev"
+      }), " 或 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm add npm-package-name --save-dev"
+      }), " 的方式来安装", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.strong, {
+        children: "仅在本地开发和测试中需要的软件包"
+      }), "，或者也可以在 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "package.json"
+      }), " 文件中手动的将需要安装的包和对应的", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://docs.npmjs.com/about-semantic-versioning",
+        target: "_blank",
+        rel: "nofollow",
+        children: "语义化版本"
+      }), "写在 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "\"devDependencies\""
+      }), " 里，并执行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm install"
+      }), " 命令："]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(CH.Code, {
+      codeConfig: chCodeConfig,
+      northPanel: {
+        "tabs": [""],
+        "active": "",
+        "heightRatio": 1
+      },
+      files: [{
+        "name": "",
+        "focus": "",
+        "code": {
+          "lines": [{
+            "tokens": [{
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "name",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "your-npm-project",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "devDependencies",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "    ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "npm-package-name",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "0.1.0",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "}",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "}",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }],
+          "lang": "json"
+        },
+        "annotations": []
+      }]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.p, {
+      children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.strong, {
+        children: ["在安装或者使用第三方 npm 包的时候一定要确定它们的用途，以及通过区分它们的类型确定好它们应该放在 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "\"dependencies\""
+        }), " 还是 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "\"devDependencies\""
+        }), " 中。"]
+      })
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.div, {
+      className: "modern-directive tip",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.p, {
+        className: "modern-directive-title",
+        children: "TIP"
+      }), (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.div, {
+        className: "modern-directive-content",
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+          children: ["\n一般来说，需要在源代码中使用到的包都属于 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+            children: "dependencies"
+          }), " 依赖。除非你通过打包的方式将依赖的代码输出到本地，那么这种情况可以将它作为 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+            children: "devDependencies"
+          }), "依赖。"]
+        })
+      })]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h2, {
+      id: "还需要了解的-npm-零碎知识",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#还需要了解的-npm-零碎知识",
+        children: "#"
+      }), "还需要了解的 npm 零碎知识"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h3, {
+      id: "npm-包的程序入口",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#npm-包的程序入口",
+        children: "#"
+      }), "npm 包的程序入口"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["在 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "package.json"
+      }), " 中存在一个 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "\"main\""
+      }), " 属性，它对应的值是一个模块 ID，或者更直观的说是一个 NodeJS 文件路径，它是你程序的主要入口。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["例如你的包名为 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "foo"
+      }), "，并且用户安装了它，然后执行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "require(\"foo\")"
+      }), " 代码，那么 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "foo"
+      }), " 这个 npm 包的 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "\"main\""
+      }), " 字段对应的文件将会被导出。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.strong, {
+        children: ["推荐在你的 npm 包里一定要设置 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "\"main\""
+        }), " 字段"]
+      }), "。如果没有设置 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "\"main\""
+      }), "，则默认入口为包的根目录下的 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "index.js"
+      }), " 文件。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["除了需要设置 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "\"main\""
+      }), " 属性以外，一般还会设置 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "\"module\""
+      }), " 属性。它与 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "\"main\""
+      }), " 属性的用途类似，它主要是用于在 webpack 场景下使用。webpack 在大多数情况下，会以 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.strong, {
+        children: "\"module\" -> \"main\""
+      }), " 这个顺序读取 npm 包的入口（文件）。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.blockquote, {
+      children: ["\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+        children: ["想要了解关于 webpack 如何做这件事，可以查看这个", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+          href: "https://webpack.js.org/configuration/resolve/#resolvemainfields",
+          target: "_blank",
+          rel: "nofollow",
+          children: "链接"
+        }), "。"]
+      }), "\n"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h3, {
+      id: "scripts",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#scripts",
+        children: "#"
+      }), (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "\"scripts\""
+      })]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "package.json"
+      }), " 文件的 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "\"scripts\""
+      }), " 属性支持一些内置的脚本和 npm 预设的生命周期事件，以及任意的脚本。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["这些都可以通过运行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm run-script <stage>"
+      }), " 或简称 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm run <stage>"
+      }), " 来执行。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["名称匹配的", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://docs.npmjs.com/cli/v9/using-npm/scripts#pre--post-scripts",
+        target: "_blank",
+        rel: "nofollow",
+        children: "前置命令和后置命令"
+      }), "也会被运行（例如 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "premyscript"
+      }), "、", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "myscript"
+      }), "、", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "postmyscript"
+      }), "）。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(CH.Code, {
+      codeConfig: chCodeConfig,
+      northPanel: {
+        "tabs": [""],
+        "active": "",
+        "heightRatio": 1
+      },
+      files: [{
+        "name": "",
+        "focus": "",
+        "code": {
+          "lines": [{
+            "tokens": [{
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "scripts",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "    ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "premyscript",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "    ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "myscript",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "    ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "postmyscript",
+              "props": {
+                "style": {
+                  "color": "#8FBCBB"
+                }
+              }
+            }, {
+              "content": "\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "\"\"",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "}",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "}",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }],
+          "lang": "json"
+        },
+        "annotations": []
+      }]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["当执行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm run myscripts"
+      }), " 的时候，", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "premyscripts"
+      }), " 对应的脚本会在它之前执行，", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "postmyscripts"
+      }), " 对应的脚本会在它之后执行。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["来自依赖的脚本命令可以用 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm explore <pkg> -- npm run <stage>"
+      }), " 运行。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.p, {
+      children: "还有一些特殊的生命周期脚本（Life Scripts），只在某些情况下发生。这里介绍几个通常需要了解的情况。"
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h4, {
+      id: "npm-install",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#npm-install",
+        children: "#"
+      }), (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm install"
+      })]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["当你运行 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm install -g <pkg-name>"
+      }), " 时，以下脚本会运行。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.ul, {
+      children: ["\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "preinstall"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "install"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "postinstall"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "prepublish"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "preprepare"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "prepare"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "postprepare"
+        })
+      }), "\n"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["如果你的软件包根目录有一个 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "binding.gyp"
+      }), " 文件，而你没有定义 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "install"
+      }), " 或 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "preinstall"
+      }), " 脚本，那么 npm 将以 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "node-gyp rebuild"
+      }), " 作为默认的 install 命令，使用 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://github.com/nodejs/node-gyp",
+        target: "_blank",
+        rel: "nofollow",
+        children: "node-gyp"
+      }), " 进行编译。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h4, {
+      id: "npm-publish",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#npm-publish",
+        children: "#"
+      }), (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "npm publish"
+      })]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.p, {
+      children: "当发布项目的时候，执行该命令会触发以下脚本："
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.ul, {
+      children: ["\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "prepublishOnly"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "prepack"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "prepare"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "postpack"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "publish"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "postpublish"
+        })
+      }), "\n"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["当以 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://docs.npmjs.com/cli/v7/commands/npm-publish#dry-run",
+        target: "_blank",
+        rel: "nofollow",
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "--dry-run"
+        })
+      }), " 模式运行的时候，", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "prepare"
+      }), " 对应的脚本将不会执行。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h3, {
+      id: "peerdependencies",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#peerdependencies",
+        children: "#"
+      }), "peerDependencies"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.p, {
+      children: "在某些情况下，你的 npm 项目与它的宿主工具或者库之间存在某种兼容关系（例如一个 webpack 插件项目和 webpack），同时你的 npm 项目不想将宿主作为必要的依赖，这个时候通常说明你的项目可能是这个宿主工具或者库的插件。你的 npm 项目会对宿主包的版本有一定的要求，因为只有在特定的版本下才会暴露出 npm 项目所需要的 API。"
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["关于更多 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "peerDependencies"
+      }), " 的解释，可以通过下面的链接了解 npm、pnpm、Yarn 对于它的不同处理方式："]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.ul, {
+      children: ["\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+          href: "https://docs.npmjs.com/cli/v9/configuring-npm/package-json#peerdependencies",
+          target: "_blank",
+          rel: "nofollow",
+          children: "npm 对 peerDependencies 的解释"
+        })
+      }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.li, {
+        children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+          href: "https://pnpm.io/feature-comparison",
+          target: "_blank",
+          rel: "nofollow",
+          children: "pnpm vs npm VS Yarn"
+        })
+      }), "\n"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h2, {
+      id: "npm-包管理器",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#npm-包管理器",
+        children: "#"
+      }), "npm 包管理器"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["除了 npm 这种标准的包管理器以外，目前主流的还有 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.strong, {
+        children: "pnpm"
+      }), " 和 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.strong, {
+        children: "Yarn"
+      }), "，它们都是不错的 npm cli 替代品。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["推荐使用 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        href: "https://pnpm.io/installation",
+        target: "_blank",
+        rel: "nofollow",
+        children: "pnpm"
+      }), " 来管理项目依赖，可以通过下面的方式安装它："]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(CH.Code, {
+      codeConfig: chCodeConfig,
+      northPanel: {
+        "tabs": [""],
+        "active": "",
+        "heightRatio": 1
+      },
+      files: [{
+        "name": "",
+        "focus": "",
+        "code": {
+          "lines": [{
+            "tokens": [{
+              "content": "npm install -g pnpm",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }]
+          }],
+          "lang": "bash"
+        },
+        "annotations": []
+      }]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.h2, {
+      id: "module-tools-配置文件",
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.a, {
+        className: "header-anchor",
+        "aria-hidden": "true",
+        href: "#module-tools-配置文件",
+        children: "#"
+      }), "Module Tools 配置文件"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: ["通过", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "@modern-js/create"
+      }), "创建的模块工程项目目录下提供了 Module Tools 的配置文件 —— ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "modern.config.(j|t)s"
+      }), "。但 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+        children: "modern.config"
+      }), " 配置文件不是必须存在的。"]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.p, {
+      children: "默认情况下，生成的配置文件的内容如下："
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(CH.Code, {
+      codeConfig: chCodeConfig,
+      northPanel: {
+        "tabs": [""],
+        "active": "",
+        "heightRatio": 1
+      },
+      files: [{
+        "name": "",
+        "focus": "",
+        "code": {
+          "lines": [{
+            "tokens": [{
+              "content": "// modern.config.ts",
+              "props": {
+                "style": {
+                  "color": "#616E88"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "import",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "moduleTools",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "defineConfig",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "}",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "from",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "'",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "@modern-js/module-tools",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "'",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ";",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }]
+          }, {
+            "tokens": []
+          }, {
+            "tokens": [{
+              "content": "export",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "default",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "defineConfig",
+              "props": {
+                "style": {
+                  "color": "#88C0D0"
+                }
+              }
+            }, {
+              "content": "(",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "plugins",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " [",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "moduleTools",
+              "props": {
+                "style": {
+                  "color": "#88C0D0"
+                }
+              }
+            }, {
+              "content": "()]",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "buildPreset",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "'",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "npm-library",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "'",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "}",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ")",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": ";",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }]
+          }],
+          "lang": "typescript"
+        },
+        "annotations": []
+      }]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.p, {
+      children: [(0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsxs)(_components.strong, {
+        children: ["我们推荐使用 ", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_components.code, {
+          children: "defineConfig"
+        }), " 函数"]
+      }), "，不过并不强制使用它。因此你也可以在配置文件中直接返回一个对象："]
+    }), "\n", (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(CH.Code, {
+      codeConfig: chCodeConfig,
+      northPanel: {
+        "tabs": [""],
+        "active": "",
+        "heightRatio": 1
+      },
+      files: [{
+        "name": "",
+        "focus": "",
+        "code": {
+          "lines": [{
+            "tokens": [{
+              "content": "// modern.config.ts",
+              "props": {
+                "style": {
+                  "color": "#616E88"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "import",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "moduleTools",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "from",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "'",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "@modern-js/module-tools",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "'",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ";",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }]
+          }, {
+            "tokens": []
+          }, {
+            "tokens": [{
+              "content": "export",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "default",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "{",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "plugins",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " [",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "moduleTools",
+              "props": {
+                "style": {
+                  "color": "#88C0D0"
+                }
+              }
+            }, {
+              "content": "()]",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "  ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "buildPreset",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9"
+                }
+              }
+            }, {
+              "content": ":",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": " ",
+              "props": {
+                "style": {
+                  "color": "#D8DEE9FF"
+                }
+              }
+            }, {
+              "content": "'",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": "npm-library",
+              "props": {
+                "style": {
+                  "color": "#A3BE8C"
+                }
+              }
+            }, {
+              "content": "'",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ",",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }]
+          }, {
+            "tokens": [{
+              "content": "}",
+              "props": {
+                "style": {
+                  "color": "#ECEFF4"
+                }
+              }
+            }, {
+              "content": ";",
+              "props": {
+                "style": {
+                  "color": "#81A1C1"
+                }
+              }
+            }]
+          }],
+          "lang": "ts"
+        },
+        "annotations": []
+      }]
+    })]
+  });
+}
+function MDXContent(props = {}) {
+  const {wrapper: MDXLayout} = props.components || ({});
+  return MDXLayout ? (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(MDXLayout, Object.assign({}, props, {
+    children: (0,react_jsx_runtime__WEBPACK_IMPORTED_MODULE_0__.jsx)(_createMdxContent, props)
+  })) : _createMdxContent(props);
+}
+/* harmony default export */ __webpack_exports__["default"] = (MDXContent);
+function _missingMdxReference(id, component, place) {
+  throw new Error("Expected " + (component ? "component" : "object") + " `" + id + "` to be defined: you likely forgot to import, pass, or provide it." + (place ? "\nIt’s referenced in your code at `" + place + "` in `/Users/bytedance/github/targeral/modern-dev/website/module-tools/docs/zh/guide/basic/before-getting-started.md`" : ""));
+}
+
+
+/***/ })
+
+}]);
+//# sourceMappingURL=zh_guide_basic_before-getting-started.js.map