PowerShell이 인식되지 않음
문제: “PowerShell이 내부 또는 외부 명령으로 인식되지 않습니다”라는 오류 메시지가 표시됩니다. 해결책:-
Windows 사용자:
- PowerShell을 시스템 PATH에 추가
- 설정 → 시스템 → 정보 → 고급 시스템 설정 → 환경 변수 열기
- PowerShell 경로 추가:
C:\Windows\System32\WindowsPowerShell\v1.0\ - PATH 변경 후 SoloEnt 재시작
-
대안:
- 대신 명령 프롬프트 (cmd) 사용
- 설정에서 기본 터미널 변경
- PowerShell이 없으면 재설치
명령을 찾을 수 없음
문제: 터미널에 “명령을 찾을 수 없음” 또는 유사한 오류가 표시됩니다. 해결책:- 명령/도구가 시스템에 설치되어 있는지 확인
- 명령이 시스템 PATH에 있는지 확인
- 새 도구 설치 후 터미널 재시작
- 필요한 경우 실행 파일의 전체 경로 사용
- 누락된 의존성 설치
Python/Node를 찾을 수 없음
문제: Python 또는 Node.js 명령이 작동하지 않습니다. 해결책:- python.org에서 Python 또는 nodejs.org에서 Node.js 설치
- 설치 확인:
python --version또는node --version - 설치되었지만 인식되지 않으면 PATH에 추가
- 설치 후 SoloEnt 재시작
- 버전 충돌 확인 (여러 Python/Node 버전)
권한 거부 오류
문제: “권한 거부됨” 또는 “액세스 거부됨” 오류가 표시됩니다. 해결책:-
macOS/Linux:
- 적절한 경우
sudo사용 ls -la로 파일 권한 확인- 시스템 설정에서 전체 디스크 접근 권한 부여
- 적절한 경우
-
Windows:
- 필요한 경우 관리자로 SoloEnt 실행
- 폴더 보안 설정 확인
- 사용자 계정 컨트롤 일시적으로 비활성화
공백이 있는 경로로 오류 발생
문제: 파일 경로에 공백이 포함되면 명령이 실패합니다. 해결책:- 경로를 따옴표로 감싸기:
"C:\My Documents\project" - 터미널에서 이스케이프 문자 사용
- 프로젝트 폴더 이름에 공백 사용 피하기
- 대신 하이픈 또는 밑줄 사용:
my-project(my project아님)
Git을 사용할 수 없음
문제: Git 명령이 작동하지 않거나 Git을 찾을 수 없습니다. 해결책:- git-scm.com에서 Git 설치
- 설치 확인:
git --version - Git을 시스템 PATH에 추가
- 설치 후 터미널/SoloEnt 재시작
- 대안으로 GitHub Desktop 사용
환경 변수가 설정되지 않음
문제: 애플리케이션이 필요한 환경 변수를 찾을 수 없습니다. 해결책:- 시스템 설정에서 변수 설정 (터미널 세션만이 아님)
- Windows: 시스템 속성 → 환경 변수
- macOS/Linux:
~/.zshrc또는~/.bashrc에 추가 - 변수 설정 후 SoloEnt 재시작
echo $VARIABLE_NAME(Unix) 또는echo %VARIABLE_NAME%(Windows)로 확인
셸 호환성 문제
문제: 명령이 한 셸에서는 작동하지만 다른 셸에서는 작동하지 않습니다. 해결책:- 사용 중인 셸 확인:
echo $SHELL - 호환되는 셸로 전환 (bash, zsh, PowerShell)
- SoloEnt 설정에서 기본 셸 구성
- 가능한 경우 크로스 플랫폼 명령 사용
시스템 아키텍처 불일치
문제: 도구 또는 바이너리가 시스템과 호환되지 않습니다. 해결책:- 시스템 아키텍처 확인:
uname -m(Unix) 또는systeminfo(Windows) - 올바른 버전 다운로드 (x64, ARM64 등)
- 호환 가능한 대안 사용
- 필요한 경우 Apple Silicon Mac에서 Rosetta 2 활성화
백신이 작업 차단
문제: 백신 소프트웨어가 SoloEnt 작업에 간섭합니다. 해결책:- SoloEnt를 백신 화이트리스트/예외에 추가
- 테스트를 위해 일시적으로 백신 비활성화
- 차단된 작업에 대한 백신 로그 확인
- 적절한 구성을 위해 백신 지원팀에 문의
디스크 공간 문제
문제: 디스크 공간 부족으로 작업이 실패합니다. 해결책:- 사용 가능한 디스크 공간 확인
- 임시 파일 및 캐시 정리
- 더 많은 공간이 있는 드라이브로 프로젝트 이동
- 불필요한 파일 삭제
네트워크/방화벽 문제
문제: API 서비스에 연결할 수 없거나 업데이트를 다운로드할 수 없습니다. 해결책:- 방화벽 설정 확인
- 방화벽에서 SoloEnt 허용
- 기업 방화벽 뒤에 있는 경우 프록시 설정 구성
- 다른 네트워크로 연결 테스트
- 기업 환경에서는 IT 부서에 문의
여전히 문제가 있나요?
이메일 지원
환경 세부 정보와 함께 지원팀에 문의하세요
Discord 참여
커뮤니티에서 도움 받기
메인 문제 해결
문제 해결 인덱스로 돌아가기
빠른 시작
설정 가이드로 돌아가기
환경 문제 보고
환경 문제를 보고할 때 다음을 포함하세요:- 운영 체제: Windows 10/11, macOS 버전, Linux 배포판
- 시스템 아키텍처: x64, ARM64, Apple Silicon
- 셸 유형: PowerShell, CMD, bash, zsh
- 오류 메시지: 모든 오류의 전체 텍스트
- 시도한 단계: 보고 전에 시도한 것