Skip to content
Merged

d2m #1545

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .vitepress/theme/landing/FeatureGrid1.vue
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ import viteAnimation from '@assets/vite/animations/563_x_420_rich_features.riv'
<div class="p-5 sm:p-10 pb-0 sm:pb-0 flex flex-col gap-3 lg:border-b-0">
<h5 class="text-white">丰富的开箱即用功能</h5>
<p class="sm:max-w-[28rem] text-pretty">
TypeScript, JSX, CSS, Workers, Web Assembly... 只需一个插件即可使用
TypeScript, JSX, CSS, Workers, WebAssembly... 只需一个插件即可使用
</p>
<RiveAnimation
:desktop-src="viteAnimation"
Expand Down
2 changes: 1 addition & 1 deletion config/shared-options.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ declare const __APP_VERSION__: string
- **类型:** `string`
- **默认:** `"node_modules/.vite"`

存储缓存文件的目录。此目录下会存储预打包的依赖项或 vite 生成的某些缓存文件,使用缓存可以提高性能。如需重新生成缓存文件,你可以使用 `--force` 命令行选项或手动删除目录。此选项的值可以是文件的绝对路径,也可以是以项目根目录为基准的相对路径。当没有检测到 package.json 时,则默认为 `.vite`。
存储缓存文件的目录。此目录下会存储预打包的依赖项或 vite 生成的某些缓存文件,使用缓存可以提高性能。如需重新生成缓存文件,你可以使用 `--force` 命令行选项或手动删除目录。此选项的值可以是文件的绝对路径,也可以是以项目根目录为基准的相对路径。当没有检测到 `package.json` 时,则默认为 `.vite`。

## resolve.alias {#resolve-alias}

Expand Down
2 changes: 2 additions & 0 deletions guide/api-environment.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,6 +100,8 @@ interface UserConfig extends EnvironmentOptions {

底层 API 配置已可用,因此可以支持为运行时提供环境。这些环境还可以生成其他进程或线程,以便在更接近生产环境的运行时间内运行开发模块。

例如,[Cloudflare Vite 插件](https://developers.cloudflare.com/workers/vite-plugin/) 使用环境 API 在开发过程中在 Cloudflare Workers 运行时 (`workerd`) 中运行代码。

```js
import { customEnvironment } from 'vite-environment-provider'

Expand Down
2 changes: 1 addition & 1 deletion guide/build.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@ export default defineConfig({
})
```

如果你指定了另一个根目录,请记住,在解析输入路径时,`__dirname` 的值将仍然是 vite.config.js 文件所在的目录。因此,你需要把对应入口文件的 `root` 的路径添加到 `resolve` 的参数中。
如果你指定了另一个根目录,请记住,在解析输入路径时,`__dirname` 的值将仍然是 `vite.config.js` 文件所在的目录。因此,你需要把对应入口文件的 `root` 的路径添加到 `resolve` 的参数中。

请注意,在 HTML 文件中,Vite 忽略了 `rolldownOptions.input` 对象中给定的入口名称,而是在生成 dist 文件夹中的 HTML 资源文件时,使用了文件已解析的路径 ID。这确保了与开发服务器的工作方式保持一致的结构。

Expand Down
58 changes: 34 additions & 24 deletions guide/static-deploy.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,42 +148,52 @@ Netlify 命令行工具(CLI)会为你提供一个预览链接,供你查看

查看 Vercel 的 [Git 集成](https://vercel.com/docs/concepts/git) 了解更多细节。

## Cloudflare Pages {#cloudflare-pages}
## Cloudflare {#cloudflare}

### Cloudflare Pages via Wrangler {#cloudflare-pages-via-wrangler}
### Cloudflare Workers {#cloudflare-workers}

1. 安装 [Wrangler CLI](https://developers.cloudflare.com/workers/wrangler/get-started/).
2. 使用 `wrangler login`、通过你的 Cloudflare 账号完成 Wrangler 身份校验。
3. 运行你的构建命令
4. 使用 `npx wrangler pages deploy dist` 部署。
[Cloudflare Vite 插件](https://developers.cloudflare.com/workers/vite-plugin/) 集成了 Cloudflare Workers,通过 Vite 的 Environment API,让你的服务端代码在开发时运行于 Cloudflare Workers 运行时环境中。

要在现有 Vite 项目中添加 Cloudflare Workers,请安装插件并将其添加到配置中:

```bash
# 安装 Wrangler CLI
$ npm install -g wrangler
$ npm install --save-dev @cloudflare/vite-plugin
```

# 使用 CLI 工具登录 Cloudflare 账号
$ wrangler login
```js [vite.config.js]
import { defineConfig } from 'vite'
import { cloudflare } from '@cloudflare/vite-plugin'

# 运行构建命令
$ npm run build
export default defineConfig({
plugins: [cloudflare()],
})
```

# 创建一个新的部署
$ npx wrangler pages deploy dist
```jsonc [wrangler.jsonc]
{
"name": "my-vite-app",
}
```

在你的资产上传后,Wrangler 会给你一个预览 URL 来检查你的网站。当你登录到 Cloudflare Pages 仪表板时,你会看到你的新项目。
运行 `npm run build` 后,你的应用就可以通过 `npx wrangler deploy` 进行部署。

你还可以轻松地为 Vite 应用添加后端 API,用于与 Cloudflare 资源进行安全通信。开发时,这些 API 运行在 Workers 运行时环境中,部署时会随前端代码一同发布。详细步骤请查看 [Cloudflare Vite 插件教程](https://developers.cloudflare.com/workers/vite-plugin/tutorial/)。

### Cloudflare Pages {#cloudflare-pages}

#### Cloudflare Pages 与 Git {#cloudflare-pages-with-git}

### Cloudflare Pages with Git {#cloudflare-pages-with-git}
Cloudflare Pages 提供了一种直接部署到 Cloudflare 的方式,而无需管理 Wrangler 文件。

1. 将你的代码推送到你的 Git 仓库(GitHub, GitLab)
2. 登录 Cloudflare 控制台,在 **Account Home** > **Pages** 下选择你的账号
3. 选择 **Create a new Project** 以及 **Connect Git** 选项
4. 选择你想要部署的 Git 项目,然后点击 **Begin setup**
5. 根据你所选择的 Vite 框架,在构建设置中选择相应的框架预设
6. 记得保存!然后部署吧
7. 然后你的应用就部署完成了!(例如: `https://<PROJECTNAME>.pages.dev/`)
1. 将你的代码推送到你的 Git 仓库(GitHub, GitLab)
2. 登录 Cloudflare 控制台,在 **Account Home** > **Workers & Pages** 下选择你的账号
3. 选择 **Create a new Project** **Pages** 选项,然后选择 Git。
4. 选择你想要部署的 Git 项目,然后点击 **Begin setup**
5. 根据你所选择的 Vite 框架,在构建设置中选择相应的框架预设。否则为你的项目输入构建命令和预期的输出目录。
6. 然后保存并部署
7. 你的应用就部署完成了!(例如:`https://<PROJECTNAME>.pages.dev/`)

在你的项目被导入和部署后,所有对该分支的后续推送都会生成一个 [预览部署](https://developers.cloudflare.com/pages/platform/preview-deployments/),除非你特意在 [控制分支构建](https://developers.cloudflare.com/pages/platform/branch-build-controls/) 的选项中写明不触发。所有对 **生产分支**(通常是 "main")的更改都会生成一个 **生产构建**。
在你的项目被导入和部署后,所有对分支的后续推送都会生成 [预览部署](https://developers.cloudflare.com/pages/platform/preview-deployments/),除非你特意在 [分支构建控制](https://developers.cloudflare.com/pages/platform/branch-build-controls/) 中写明不触发。所有对 **生产分支**(通常是 "main")的更改都会生成一个 **生产部署**。

你也可以添加自定义域名,并自定义各个页面的构建设置。查看 [Cloudflare 页面与 Git 集成](https://developers.cloudflare.com/pages/get-started/#manage-your-site) 了解更多详情。

Expand Down