首页演练场案例展示应用文档博客
    • English英语
      EN
    • русский俄语
      RU
    • 日本語日语
      JA
    • français法语
      FR
    • 한국어韩语
      KO
    • 中文中文
      ZH
    • español西班牙语
      ES
    • Deutsch德语
      DE
    • العربية阿拉伯语
      AR
    • italiano意大利语
      IT
    • British English英国英语
      EN-GB
    • português葡萄牙语
      PT
    • हिन्दी印地语
      HI
    • Türkçe土耳其语
      TR
    • polski波兰语
      PL
    • Indonesia印度尼西亚语
      ID
    • Tiếng Việt越南语
      VI
    • українська乌克兰语
      UK
    /
    按框架筛选文档
    Alt+←
    为什么Intlayer?
    开始
    概念
    • Intlayer如何工作
    • 配置
    • TestFillBuildWatchExtractLoginPushPullConfigurationListVersionEditorLiveDebugDoc ReviewDoc TranslateSDK
    • 可视化编辑器
    • CMS
    • CI/CD集成
    • 翻译复数枚举条件性别插入文件嵌套MarkdownHTML函数获取
    • 每个语言环境的文件
    • 编译器
    • 自动填充
    • 测试
    • 打包优化
    环境
    • Next.js 14和应用路由器
      Next.js 15
      Next.js 无 locale URL
      Next.js和页面路由器
      编译器
    • Tanstack Start Solid
    • Astro和React
      Astro和Svelte
      Astro和Vue
      Astro和Solid
      Astro和Preact
      Astro和Lit
      Astro和Vanilla JS
    • React Router v7
      React Router v7 (fs-routes)
      Compiler
    • Nuxt和Vue
    • Vite和Solid
    • SvelteKit
    • Vite和Preact
    • Vite和Vanilla JS
    • Vite和Lit
    • Angular 19 (Webpack)
      Analog
    • React CRA
    • React Native和Expo
    • Express.js
      NestJS
      Fastify
      Hono
      Adonis
    • Lynx和React
    Plugins
    • JSON
    • gettext (.po)
    VS Code扩展
    代理
    • MCP服务器
    • 代理技能
    发布
    • v8
    • v7
    • v6
    基准测试
    • Next.js
    • TanStack
    • Vue
    • Solid
    • Svelte
    博客
    问问题
    1. Documentation
    2. 概念
    3. CLI
    4. Init
    Creation:2025-12-30Last update:2025-12-30
    将此文档参考到您的 AI 助手
    ChatGPT
    Claude
    DeepSeek
    Google AI mode
    Gemini
    Perplexity
    Mistral
    Grok

    使用您最喜欢的AI助手总结文档,并引用此页面和AI提供商

    版本历史

    1. "添加 --no-gitignore 选项"
      v8.6.42026/3/31
    2. "添加 init 命令内容"
      v7.5.92025/12/30

    此页面的内容已使用 AI 翻译。

    查看英文原文的最新版本
    编辑此文档

    如果您有改善此文档的想法,请随时通过在GitHub上提交拉取请求来贡献。

    文档的 GitHub 链接
    Copy

    复制文档 Markdown 到剪贴板

    初始化 Intlayer

    bash
    复制代码

    复制代码到剪贴板

    npx intlayer init

    init 命令通过创建必要的文件和设置,在您的项目中自动配置 Intlayer。这是开始使用 Intlayer 的推荐方式。

    别名:

    • npx intlayer init

    参数:

    • --project-root [projectRoot] - 可选。指定项目的根目录。如果未提供,命令将从当前工作目录开始搜索项目根目录。
    • --no-gitignore - 可选。跳过自动更新 .gitignore 文件。如果设置了此标志,.intlayer 将不会添加到 .gitignore 中。

    工作原理:

    init 命令执行以下设置任务:

    1. 验证项目结构 - 确保您位于包含 package.json 文件的有效项目目录中。
    2. 更新 .gitignore - 将 .intlayer 添加到您的 .gitignore 文件中,以将生成的文件排除在版本控制之外(可以使用 --no-gitignore 跳过)。
    3. 配置 TypeScript - 更新任何 tsconfig.json 文件以包含 Intlayer 类型定义 (.intlayer/**/*.ts)。
    4. 创建配置文件 - 使用默认设置生成 intlayer.config.ts(对于 TypeScript 项目)或 intlayer.config.mjs(对于 JavaScript 项目)。
    5. 更新 Vite 配置 - 如果检测到 Vite 配置文件,将添加 vite-intlayer 插件的导入。
    6. 更新 Next.js 配置 - 如果检测到 Next.js 配置文件,将添加 next-intlayer 插件的导入。

    示例:

    基础初始化:

    bash
    复制代码

    复制代码到剪贴板

    npx intlayer init

    这将在当前目录中初始化 Intlayer,并自动检测项目根目录。

    使用自定义项目根目录初始化:

    bash
    复制代码

    复制代码到剪贴板

    npx intlayer init --project-root ./my-project

    这将在指定的目录中初始化 Intlayer。

    初始化而不更新 .gitignore:

    bash
    复制代码

    复制代码到剪贴板

    npx intlayer init --no-gitignore

    这将设置所有配置文件,但不会修改您的 .gitignore。

    输出示例:

    bash
    复制代码

    复制代码到剪贴板

    npx intlayer initChecking Intlayer configuration...✓ Added .intlayer to .gitignore✓ Updated tsconfig.json to include intlayer types✓ Created intlayer.config.ts✓ Injected import into vite.config.ts✓ Intlayer init setup complete.

    注意事项:

    • 该命令是幂等的--您可以安全地多次运行它。已配置的步骤将被跳过。
    • 如果配置文件已存在,则不会被覆盖。
    • 不包含 include 数组的 TypeScript 配置(例如带有引用的 solution-style 配置)将被跳过。
    • 如果在项目根目录中未找到 package.json,该命令将报错退出。
    为什么Intlayer?
    Alt+→

    在此页面

      讨论是匿名的,并会定期审查以解决常见问题。欢迎分享功能想法、对文档的反馈或任何与 Intlayer 相关的内容, 我们会利用这些意见来制定路线图并改进产品。

      npx intlayer init
      npx intlayer init
      npx intlayer init --project-root ./my-project
      npx intlayer init --no-gitignore
      npx intlayer initChecking Intlayer configuration...✓ Added .intlayer to .gitignore✓ Updated tsconfig.json to include intlayer types✓ Created intlayer.config.ts✓ Injected import into vite.config.ts✓ Intlayer init setup complete.