docs(en): merge docs-cn/sync-docs into docs-cn/dev @ f5fe3f6

Author: ShenQingchuan

config/index.md

@@ -178,6 +178,7 @@ export default defineConfig(async ({ command, mode }) => {
 
 ### resolve.conditions
 
+
 - **类型：** `string[]`
 
   解决程序包中 [情景导出](https://nodejs.org/api/packages.html#packages_conditional_exports) 时的其他允许条件。
@@ -363,7 +364,7 @@ export default defineConfig(async ({ command, mode }) => {
 
   以 `envPrefix` 开头的环境变量会通过 import.meta.env 暴露在你的客户端源码中。
 
-  :::warning SECURITY NOTES
+  :::warning 安全注意事项
   `envPrefix` 不应被设置为空字符串 `''`，这将暴露你所有的环境变量，导致敏感信息的意外泄漏。 检测到配置为 `''` 时 Vite 将会抛出错误.
   :::
 
@@ -686,7 +687,11 @@ export default defineConfig({
 
   如果禁用，整个项目中的所有 CSS 将被提取到一个 CSS 文件中。
 
-### build.cssTarget {#build-csstarget}
+  ::: tip 注意
+  如果指定了 `build.lib`，`build.cssCodeSplit` 会默认为 `false`。
+  :::
+
+### build.cssTarget
 
 - **类型：** `string | string[]`
 - **默认值：** 与 [`build.target`](/config/#build-target) 一致

guide/api-javascript.md

@@ -102,6 +102,12 @@ interface ViteDevServer {
    * 启动服务器
    */
   listen(port?: number, isRestart?: boolean): Promise<ViteDevServer>
+  /**
+   * 重启服务器
+   *
+   * @param forceOptimize - 强制优化器重新大伯啊，和命令行内使用 --force 一致
+   */
+  restart(forceOptimize?: boolean): Promise<void>
   /**
    * 停止服务器
    */

guide/api-plugin.md

@@ -36,6 +36,7 @@ Vite 努力秉承开箱即用的原则，因此在创作一款新插件前，请
 - `vite-plugin-react-` 前缀作为 React 插件
 - `vite-plugin-svelte-` 前缀作为 Svelte 插件
 
+
 Vite 对虚拟模块的规范是在路径前加上 `virtual:`。如果可能的话，插件名应该作为命名空间使用，以避免与生态系统中的其他插件发生冲突。例如，`vite-plugin-posts` 可以让用户引入 `virtual:posts` 或 `virtual:posts/helpers` 虚拟模块，以获得构建时信息。在内部，使用虚拟模块的插件在解析模块 ID 时应以 `\0` 为前缀，这是一个来自 Rollup 生态系统的惯例。这可以防止其他插件试图处理这个 ID（如节点解析），而像 sourcemap 这样的核心功能可以使用这些信息来区分虚拟模块和普通文件。`\0` 在导入的 URL 中不是一个允许的字符，所以我们必须在导入分析中替换它们。在浏览器中，一个 `0{id}` 的虚拟 ID 最终被编码为 `/@id/__x00__{id}`。在进入插件处理管道之前，这个 ID 会被解码回来。所以这个过程在插件钩子代码中将是不可见的。
 
 请注意，模块都直接来源于真实的文件，而单文件组件（比如 .vue 或 .svelte 文件）中的 script 模块将不需要这样的转换。单文件组件被处理时一般会生成一系列子模块但其代码都可以被映射回文件系统。对这些子模块使用 `\0` 会使得 sourcemap 工作异常。

guide/index.md

@@ -137,10 +137,10 @@ cd vite
 pnpm install
 cd packages/vite
 pnpm run build
-pnpm link # you can use your preferred package manager for this step
+pnpm link --global # you can use your preferred package manager for this step
 ```
 
-然后，回到你的 Vite 项目并运行 `pnpm link vite`（或者使用全局的软链来链接 `vite`）。重新启动开发服务器来体验新功能吧！
+然后，回到你的 Vite 项目并运行 `pnpm link --global vite`（或者使用你的其他包管理工具来全局链接 `vite`）。重新启动开发服务器来体验新功能吧！
 
 ## 社区 {#community}