Программирование
Поисковый справочник по командам терминала для редактирования, запуска, тестирования и отладки веб-проекта.
33 команд
Навигация
pwd
pwdВыводит абсолютный путь к папке, в которой в данный момент работает терминал.
Запустите его перед командами, которые требуют нахождения в папке проекта.
pwdПроверьте, в какой папке находится текущий терминал.
Навигация
ls
lsПеречисляет файлы и папки в текущем каталоге.
Используйте это для проверки наличия ожидаемых файлов, таких как package.json, src или next.config.mjs.
lsПеречислите файлы в текущей папке проекта.
Навигация
cd
cd ~/projects/my-web-appПеремещает терминал в другую папку.
Используйте это перед выполнением команд, специфичных для проекта, таких как npm run build.
Команда может завершиться неудачей, если вы находитесь в неправильной папке, даже если сама команда правильная.
cd ~/projects/my-web-appПерейдите в папку проекта перед выполнением команд.
Навигация
clear
clearОчищает видимый вывод терминала, не изменяя файлы или историю команд.
Используйте это перед повторным запуском команды, если старый вывод визуально зашумлен.
clearОчистите терминал перед повторным запуском сборки.
Файлы и папки
cat
cat package.jsonВыводит содержимое файла в терминал.
Используйте это для небольших файлов, таких как package.json, файлов конфигурации или небольших текстовых файлов.
Для очень больших файлов предпочтительнее использовать `sed`, `rg` или программу просмотра, чем выводить все на экран.
cat package.jsonОтображать скрипты из файла package.json.
Файлы и папки
sed
sed -n '1,120p' src/components/SiteHeader.tsxМожно распечатать выбранный диапазон строк из файла.
Используйте это для изучения одной секции файла исходного кода без открытия всего файла.
sed -n '1,120p' src/components/SiteHeader.tsxОтображать первые 120 строк файла SiteHeader.tsx.
Файлы и папки
mkdir
mkdir -p src/app/[locale]/reference/terminal-commandsСоздает новую папку. Опция -p также создает отсутствующие родительские папки и предотвращает сбой, если папка уже существует.
Используйте это перед добавлением новой папки со страницами или папки с ресурсами.
mkdir -p src/app/[locale]/reference/terminal-commandsСоздайте папку маршрутов для страницы с командами терминала.
Файлы и папки
cp
cp .env.example .env.localКопирует файл или папку в другое место.
Используйте это для создания локальной конфигурации из файла-примера или дублирования шаблона.
Если целевой файл существует, cp может перезаписать его.
cp .env.example .env.localКопирует файл с примером настроек только в том случае, если это не перезапишет локальные настройки.
Файлы и папки
mv
mv old-name.ts new-name.tsПеремещает файл или папку, или переименовывает его, если целевая папка находится в той же папке.
Используйте это, когда изменяется имя файла, имя папки маршрута или перемещаются ресурсы.
Переименование папок маршрутов изменяет URL-адреса.
mv old-name.ts new-name.tsПереименовать этот файл и обновить импорты, если это необходимо.
Безопасность
rm
rm unused-file.tsУдаляет файлы. С параметром -r может рекурсивно удалять папки.
Используйте это только тогда, когда файл намеренно удаляется из проекта.
rm is destructive. Check the path carefully before running it.
rm unused-file.tsПеред удалением этого файла объясните, что будет удалено.
Поиск и проверка
rg
rg -n "errorMessageGuide" srcБыстрый поиск текста по всем файлам.
Используйте это для поиска импортов, компонентов, псевдонимов, классов CSS или старых названий перед редактированием.
rg -n "errorMessageGuide" srcПоиск места импорта этого компонента.
Поиск и проверка
rg --files
rg --files src/appПеречисляет пути к файлам быстро, соблюдая общие правила игнорирования.
Используйте это для поиска файлов страниц, компонентов и библиотек без сканирования выходных данных сборки.
rg --files src/appПеречислите файлы справочной страницы в каталоге src/app.
Поиск и проверка
find
find src -name 'page.tsx'Поиск по файловой системе по пути, имени или другим свойствам файла.
Используйте это при поиске по шаблону имени файла, а не по содержимому текста.
find src -name 'page.tsx'Найдите все файлы маршрутов page.tsx.
Поиск и проверка
wc
wc -l src/lib/terminal-commands.tsПодсчитывает строки, слова или байты.
Используйте это для оценки размера файла или количества результатов поиска при использовании с другими командами.
wc -l src/lib/terminal-commands.tsПодсчитайте количество строк в этом файле данных.
Пакеты
npm install
npm installУстанавливает пакеты, перечисленные в файлах package.json и package-lock.json.
Используйте это после клонирования проекта или когда отсутствуют зависимости.
Это может изменить файл package-lock.json, если версии зависимостей разрешаются по-разному.
npm installУстановите зависимости только в том случае, если папка node_modules отсутствует.
Dev-сервер
npm run dev
npm run devЗапускает локальный скрипт разработки проекта.
Используйте это для тестирования страниц в браузере во время редактирования.
Запущенный сервер разработки поддерживает активную сессию терминала до остановки.
npm run devЗапустите сервер разработки и сообщите мне локальный URL.
Пакеты
npm run build
npm run buildЗапускает скрипт сборки для продакшена и обнаруживает множество проблем компиляции, маршрутизации и типов.
Запустите его перед развертыванием или после добавления новых страниц.
npm run buildЗапустите сборку для продакшена и суммируйте предупреждения или ошибки.
Пакеты
npm run lint
npm run lintЗапускает скрипт линтинга проекта для обнаружения проблем со стилем и статическим кодом.
Запустите его перед сборкой, если вам нужен быстрый отзыв.
npm run lintЗапустите lint и отображайте только ошибки, требующие исправления.
Пакеты
node -v
node -vВыводит установленную версию Node.js.
Используйте это, когда проекту или зависимости требуется определенная версия Node.
node -vПроверьте версию Node.js перед объяснением этого предупреждения.
Пакеты
npx
npx next infoЗапускает команду из установленного или временно загруженного пакета npm.
Используйте это для одноразовых команд, когда нет скрипта для сборки.
npx can download packages from the network if they are not installed.
npx next infoОбъясните, требует ли эта команда npx сетевого доступа.
Git
git status
git status --shortПоказывает текущую ветку и измененные, подготовленные или неотслеживаемые файлы.
Запустите его перед редактированием, коммитом, извлечением или переключением ветки.
git status --shortПроверьте состояние Git и суммируйте измененные файлы.
Git
git diff
git diff -- src/components/SiteHeader.tsxПоказывает различия построчно в измененных файлах.
Используйте это для проверки изменений перед фиксацией.
git diff -- src/components/SiteHeader.tsxПросмотрите изменения (diff) для этой задачи.
Git
git log
git log --oneline -5Показывает историю коммитов.
Используйте это для просмотра последних изменений или поиска коммита для проверки.
git log --oneline -5Отображать пять последних коммитов.
Git
git add
git add src/lib/terminal-commands.tsВыбирает изменения, которые будут включены в следующий коммит.
Используйте явные пути для сфокусированных коммитов.
git add src/lib/terminal-commands.tsДобавьте только файлы, относящиеся к этой странице с командами терминала.
Git
git commit
git commit -m "Add terminal command reference"Записывает внесенные изменения в историю Git.
Используйте это после просмотра внесенных изменений.
git commit -m "Add terminal command reference"Зафиксируйте внесенные изменения с четким сообщением.
Dev-сервер
Ctrl+C
Нажмите Ctrl+C в терминале сервера разработки.Прерывает текущую выполняемую команду терминала.
Используйте это для остановки локального сервера разработки перед закрытием терминала или изменением портов.
Используйте это в сессии терминала, где выполняется команда.
Нажмите Ctrl+C в терминале сервера разработки.Остановите работающий сервер разработки.
Dev-сервер
lsof
lsof -i :3001Можно показать, какой процесс использует порт.
Используйте это, когда сервер разработки завершается с ошибкой EADDRINUSE.
lsof -i :3001Найдите процесс, использующий порт 3001.
Dev-сервер
ps
ps auxПоказывает запущенные процессы.
Используйте это для изучения работающих инструментов разработки, серверов или фоновых процессов.
ps auxПроверьте, работает ли сервер Next.js в режиме разработки.
Безопасность
kill
kill 12345Отправляет сигнал для остановки процесса по его ID.
Используйте это, когда сервер продолжает работать после того, как обычное прерывание недоступно.
Проверьте PID, чтобы случайно не остановить неправильный процесс.
kill 12345Перед завершением процесса покажите, чему принадлежит PID.
Сеть
curl
curl -I http://localhost:3001/koОтправляет HTTP-запросы из терминала и выводит ответ.
Используйте это, чтобы проверить, возвращает ли локальный или развернутый URL-адрес код 200, 404, 500 или перенаправление.
curl -I http://localhost:3001/koИспользуйте `curl` для проверки, возвращает ли эта страница 200.
Сеть
ping
ping 172.30.1.55Проверка, отвечает ли хост на базовые сетевые пакеты.
Используйте это для проверки доступности сети, а не для проверки работоспособности веб-приложения.
ping 172.30.1.55Проверьте, может ли это устройство получить доступ к IP-адресу машины разработчика.
Поиск и проверка
which
which nodeПоказывает, какой исполняемый файл будет запущен для указанного имени команды.
Используйте это, когда на машине могут существовать разные версии Node, npm или инструментов.
which nodeПроверьте, какой исполняемый файл Node используется.
Безопасность
chmod
chmod +x script.shИзменяет права доступа на чтение, запись или выполнение для файлов.
Используйте это, когда локальный скрипт должен быть исполняемым.
Избегайте широких изменений разрешений, таких как chmod -R 777.
chmod +x script.shОбъясните самое безопасное изменение разрешения для этого скрипта.