Skip to content

Commit cb9448e

Browse files
authored
Merge pull request #1240 from vitejs/sync-c051c833-1
docs(en): merge docs-cn/sync-docs into docs-cn/dev @ c051c83
2 parents efc04de + 3386b82 commit cb9448e

File tree

4 files changed

+19
-35
lines changed

4 files changed

+19
-35
lines changed

guide/dep-pre-bundling.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,6 @@ Vite 将预构建的依赖项缓存到 `node_modules/.vite` 中。它会基于
8383

8484
已预构建的依赖请求使用 HTTP 头 `max-age=31536000, immutable` 进行强缓存,以提高开发期间页面重新加载的性能。一旦被缓存,这些请求将永远不会再次访问开发服务器。如果安装了不同版本的依赖项(这反映在包管理器的 lockfile 中),则会通过附加版本查询自动失效。如果你想通过本地编辑来调试依赖项,您可以:
8585

86-
1. 通过浏览器开发工具的 Network 选项卡暂时禁用缓存
87-
2. 重启 Vite 开发服务器指定 `--force` 选项,来重新构建依赖项;
86+
1. 通过浏览器开发工具的 Network 选项卡暂时禁用缓存
87+
2. 重启 Vite 开发服务器指定 `--force` 选项,来重新构建依赖项
8888
3. 重新载入页面。

guide/features.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -176,7 +176,7 @@ HTML 文件位于 Vite 项目的[最前端和中心](/guide/#index-html-and-proj
176176
- `<audio src>`
177177
- `<embed src>`
178178
- `<img src>``<img srcset>`
179-
- `<image src>`
179+
- `<image href>``<image xlink:href>`
180180
- `<input src>`
181181
- `<link href>``<link imagesrcset>`
182182
- `<object data>`

guide/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Vite 还提供了强大的扩展性,可通过其 [插件 API](./api-plugin)
4444
## 搭建第一个 Vite 项目 {#scaffolding-your-first-vite-project}
4545

4646
::: tip 兼容性注意
47-
Vite 需要 [Node.js](https://nodejs.org/en/) 版本 20+。然而,有些模板需要依赖更高的 Node 版本才能正常运行,当你的包管理器发出警告时,请注意升级你的 Node 版本。
47+
Vite 需要 [Node.js](https://nodejs.org/en/) 版本 20.19+, 22.12+。然而,有些模板需要依赖更高的 Node 版本才能正常运行,当你的包管理器发出警告时,请注意升级你的 Node 版本。
4848
:::
4949

5050
::: code-group

guide/troubleshooting.md

Lines changed: 15 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -4,37 +4,6 @@
44
55
如果这里的建议并未帮助到你,请将你的问题发送到 [GitHub 讨论区](https://github.com/vitejs/vite/discussions)[Vite Land Discord](https://chat.vite.dev)`#help` 频道。
66

7-
## CJS
8-
9-
### Vite CJS Node API deprecated {#vite-cjs-node-api-deprecated}
10-
11-
Vite 的 CJS Node API 构建已经被废弃,并将在 Vite 6 中移除。查看 [GitHub 讨论区](https://github.com/vitejs/vite/discussions/13928) 了解更多背景信息。你应该更新你的文件或框架来导入 Vite 的 ESM 构建。
12-
13-
在一个基础的 Vite 项目中,请确保:
14-
15-
1. `vite.config.js` 配置文件的内容使用 ESM 语法。
16-
2. 最近的 `package.json` 文件中有 `"type": "module"`,或者使用 `.mjs`/`.mts` 扩展名,例如 `vite.config.mjs` 或者 `vite.config.mts`
17-
18-
对于其他项目,有几种常见的方法:
19-
20-
- **配置 ESM 为默认,如果需要则选择 CJS:** 在项目 `package.json` 中添加 `"type": "module"`。所有 `*.js` 文件现在都被解释为 ESM,并且需要使用 ESM 语法。你可以将一个文件重命名为 `.cjs` 扩展名来继续使用 CJS。
21-
- **保持 CJS 为默认,如果需要则选择 ESM:** 如果项目 `package.json` 没有 `"type": "module"`,所有 `*.js` 文件都被解释为 CJS。你可以将一个文件重命名为 `.mjs` 扩展名来使用 ESM。
22-
- **动态导入 Vite:** 如果你需要继续使用 CJS,你可以使用 `import('vite')` 动态导入 Vite。这要求你的代码必须在一个 `async` 上下文中编写,但是由于 Vite 的 API 大多是异步的,所以应该还是可以管理的。
23-
24-
如果你不确定警告来自哪里,你可以通过 `VITE_CJS_TRACE=true` 标志运行你的脚本来记录堆栈跟踪:
25-
26-
```bash
27-
VITE_CJS_TRACE=true vite dev
28-
```
29-
30-
如果你想暂时忽略警告,你可以通过 `VITE_CJS_IGNORE_WARNING=true` 标志运行你的脚本:
31-
32-
```bash
33-
VITE_CJS_IGNORE_WARNING=true vite dev
34-
```
35-
36-
请注意,postcss 配置文件还不支持 ESM + TypeScript(`"type": "module"` 中的 `.mts``.ts`)。如果你有带 `.ts` 的 postcss 配置,并在 package.json 中添加了 `"type": "module"`,你还需要将 postcss 配置重命名为 `.cts`
37-
387
## CLI {#cli}
398

409
### `Error: Cannot find module 'C:\foo\bar&baz\vite\bin\vite.js'` {#error-cannot-find-module-cfoobarbazvitebinvitejs}
@@ -245,3 +214,18 @@ Vite 无法处理、也不支持仅可在非严格模式(sloppy mode)下运
245214
- 通过 `mklink` 命令将符号链接/联接到另一个驱动器(例如 Yarn 全局缓存)
246215

247216
相关 issue:[#10802](https://github.com/vitejs/vite/issues/10802)
217+
218+
<script setup lang="ts">
219+
// 使用哈希将旧链接重定向到旧版本文档
220+
if (typeof window !== "undefined") {
221+
const hashForOldVersion = {
222+
'vite-cjs-node-api-deprecated': 6
223+
}
224+
225+
const version = hashForOldVersion[location.hash.slice(1)]
226+
if (version) {
227+
// 更新 scheme 和端口,以便它在本地预览中工作(本地为 http 和 4173)
228+
location.href = `https://v${version}.vite.dev` + location.pathname + location.search + location.hash
229+
}
230+
}
231+
</script>

0 commit comments

Comments
 (0)