Eclipse에서 jQuery 오류 표시 제거하기 - JavaScript Include Path 설정

원본 작성일: 2014.02.15
보완 작성일: 2026.02.14

Eclipse에서 jQuery 파일에 빨간 X 오류 표시가 뜨는 경우가 있다. 빌드나 실행에는 아무 문제가 없는데 Project Explorer에서 거슬린다.

왜 발생하는가

Eclipse의 JavaScript 검증기(JSDT)가 jQuery의 minified 코드를 파싱하면서 문법 오류로 판단하는 것이다. jQuery는 정상적인 코드지만, 축소(minify)된 코드가 Eclipse의 검증 규칙과 맞지 않아서 발생한다.

해결 방법

jQuery 파일을 JavaScript Include Path에서 제외하면 된다.

1. 프로젝트 속성 열기

프로젝트 우클릭 → Properties

2. JavaScript Include Path 이동

좌측 메뉴에서 JavaScript → Include Path 선택

3. Source 탭에서 Exclusion 설정

• Source 탭 선택
• Excluded: (None) 항목을 더블클릭 (또는 Edit 클릭)

4. 제외 패턴 추가

Exclusion patterns에서 Add 클릭 후 입력:

**/jquery.min.js

다른 라이브러리도 같은 문제가 있으면 패턴을 추가한다:

**/jquery.min.js
**/jquery-ui.min.js
**/bootstrap.min.js

**는 하위 폴더를 포함한 모든 경로를 의미한다.

5. 확인

OK → 프로젝트 빌드 후 오류 표시가 사라진다.

대안: JavaScript 검증 자체를 끄기

특정 파일이 아니라 전체 JS 검증이 불필요하면:

1. 프로젝트 우클릭 → Properties
2. Builders 선택
3. JavaScript Validator 체크 해제

다만 이 방법은 모든 JS 파일의 검증을 끄는 것이라, 본인이 작성한 코드의 오류도 못 잡게 된다. Exclusion 패턴으로 특정 파일만 제외하는 게 낫다.

관련 글: Eclipse 설치와 Workspace 설정