Ссылки на проекты (введение)
Разделяйте код на несколько проектов tsconfig и связывайте их ссылками для ускорения инкрементальных сборок.
«Ссылки на проекты (введение)» — бесплатный урок TypeScript Academy на CoddyKit. Это урок 3 из 3. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения TypeScript Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс TypeScript Academy содержит 3 уроков всего.
Введение
Цель: изучить ссылки на проекты. Они связывают несколько проектов tsconfig, ускоряя сборку и улучшая организацию.
Корневая конфигурация
В корне добавьте массив references. Каждый путь указывает на папку другого проекта tsconfig.
// tsconfig.json (root)
{
"files": [],
"references": [
{ "path": "./core" },
{ "path": "./web" }
]
}Составной проект
В каждом проекте, на который есть ссылка, необходимо включить параметр composite. Это позволяет TypeScript создавать метаданные для отслеживания зависимостей.
// core/tsconfig.json
{
"compilerOptions": {
"composite": true,
"outDir": "../dist/core"
},
"include": ["src"]
}Ссылка на другой проект
Проект web ссылается на core. tsc сначала соберёт core, затем web, повторно используя результаты.
// web/tsconfig.json
{
"compilerOptions": {
"composite": true,
"outDir": "../dist/web"
},
"references": [
{ "path": "../core" }
]
}Команда сборки
Используйте tsc --build (или -b), чтобы скомпилировать все проекты, на которые есть ссылки. Инкрементальные сборки выполняются гораздо быстрее.
// Build all projects
npx tsc --build
// Incremental rebuild when only core changes
npx tsc --build coreПоддержка IDE
VS Code понимает ссылки на проекты: позволяет переходить между проектами, единообразно показывать ошибки и повторно использовать созданные объявления.
Проверка преимуществ
Быстрая проверка: в чём главное преимущество ссылок на проекты?
Повторение
Повторение: ссылки на проекты разделяют код на подпроекты с конфигурациями composite. Они ускоряют сборку и улучшают организацию больших репозиториев.
Часто задаваемые вопросы
Урок «Ссылки на проекты (введение)» бесплатный?
Да — полный текст урока «Ссылки на проекты (введение)» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс TypeScript Academy, подпишись на CoddyKit PRO. Курс TypeScript Academy содержит 3 уроков всего.
Чему я научусь в уроке «Ссылки на проекты (введение)»?
Разделяйте код на несколько проектов tsconfig и связывайте их ссылками для ускорения инкрементальных сборок. Ты практикуешь TypeScript Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать TypeScript Academy?
Предыдущий опыт не требуется. TypeScript Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 3.
Сколько времени занимает урок «Ссылки на проекты (введение)»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке TypeScript Academy?
Да. Каждый урок TypeScript Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Флаги строгости
- Настройки target, lib, module и JSX
- Ссылки на проекты (введение)