📘검사 설명

📊 개요

넣은 파일의 수와 줄 수를 세요. 줄은 코드 줄(실제로 동작하는 줄), 주석 줄(사람에게 설명하는 줄), 빈 줄로 나눠 세요. 확장자로 언어(자바스크립트·타입스크립트·HTML·CSS·파이썬·Lua·JSON·마크다운 등)를 알아내서 언어별 비율을 막대로 보여 주고, 가장 긴 파일 목록도 보여 줘요.

node_modules, .git, dist, build처럼 남이 만들었거나 자동으로 만든 폴더, 그림·글꼴·압축 파일, 2MB가 넘는 파일, 잠금 파일과 .min.js는 건너뛰고 "건너뛴 파일" 목록에 이유와 함께 적어요.

🔑 비밀 정보 섞임

API 키·토큰·비밀번호·개인 키가 코드나 설정 파일에 그대로 들어 있는지 찾아요. 서비스마다 생긴 모양(예: AWS는 AKIA로 시작)과, password·secret·token 같은 이름에 뒤죽박죽한 값이 들어 있는지를 봐요. 찾은 값은 화면과 보고서 어디에도 그대로 보여 주지 않고 앞 4글자만 보여 줘요.

// 코드에는 이름만, 진짜 값은 환경 변수에
const apiKey = process.env.API_KEY;

# .gitignore
.env

// 코드에는 이름만, 진짜 값은 환경 변수에
const apiKey = process.env.API_KEY;

# .gitignore
.env

// 코드에는 이름만, 진짜 값은 환경 변수에
const apiKey = process.env.API_KEY;

# .gitignore
.env

// 코드에는 이름만, 진짜 값은 환경 변수에
const apiKey = process.env.API_KEY;

# .gitignore
.env

// 코드에는 이름만, 진짜 값은 환경 변수에
const apiKey = process.env.API_KEY;

# .gitignore
.env

// 코드에는 이름만, 진짜 값은 환경 변수에
const apiKey = process.env.API_KEY;

# .gitignore
.env

# .gitignore
*.pem
*.key
id_rsa*

// 시험용 토큰은 그때그때 만들기
const token = await makeTestToken({ expiresIn: '5m' });

// 코드에는 이름만, 진짜 값은 환경 변수에
const apiKey = process.env.API_KEY;

# .gitignore
.env

# .env.example (값은 비워서 공유)
API_KEY=
DB_PASSWORD=

# .gitignore
.env
.env.*
!.env.example

🛡️ 취약점(약한 곳)

공격받기 쉬운 코드 모양을 찾아요. 이용자가 넣은 값이 HTML·SQL·명령 줄·코드 실행으로 그대로 흘러가는 곳이 가장 위험해요. 같은 규칙이라도 이용자 값처럼 보이는 이름(input, query, user…)이 섞이면 위험도를 높게 표시하고, 글자를 그대로 쓴 안전한 경우(예: innerHTML = "<b>안녕</b>")는 빼요.

// 데이터라면
const data = JSON.parse(text);
// 정해진 동작 중 고르기라면
const actions = { save, load };
actions[name]?.();

const ops = { add: (a, b) => a + b, sub: (a, b) => a - b };
const result = ops[op] ? ops[op](a, b) : 0;

setTimeout(() => showMessage(), 1000);

el.textContent = userText;

// 모양이 필요하면 요소를 직접 만들기
const b = document.createElement('b');
b.textContent = userName;
el.append(b);

const p = document.createElement('p');
p.textContent = message;
document.body.append(p);

<p>{comment.text}</p>

// 자바스크립트
db.query('SELECT * FROM users WHERE id = ?', [id]);

# 파이썬
cur.execute("SELECT * FROM users WHERE id = %s", (user_id,))

import { execFile } from 'node:child_process';
execFile('ls', ['-l', folder], (err, out) => { /* ... */ });

const token = crypto.randomUUID();
const n = crypto.getRandomValues(new Uint32Array(1))[0];

# 파이썬
import secrets
token = secrets.token_urlsafe(32)

<img src="https://cdn.example/logo.png" alt="로고">

<a href="https://leapinity.com" target="_blank" rel="noopener noreferrer">Leapinity</a>

<meta http-equiv="Content-Security-Policy"
      content="default-src 'self'; script-src 'self'; object-src 'none'">

// Node
https.request(url, { /* rejectUnauthorized 기본값(true) 그대로 */ });

# 파이썬
requests.get(url)  # verify=True 가 기본

import ast, json
value = ast.literal_eval(text)   # 숫자·글자·목록만 허용
data = json.loads(text)

import json
data = json.loads(received_text)

import subprocess
subprocess.run(["ls", "-l", folder], check=True)

import yaml
config = yaml.safe_load(text)

local actions = { jump = doJump, dance = doDance }
local fn = actions[name]
if fn then fn() end

BuyEvent.OnServerEvent:Connect(function(player, itemId)
  local item = Items[itemId]            -- 서버의 표에서 찾기
  if typeof(itemId) ~= "string" or not item then return end
  local coins = player.leaderstats.Coins
  if coins.Value < item.price then return end  -- 가격은 서버가 정함
  coins.Value -= item.price
end)

🐛 흔한 실수

당장 위험하진 않지만 버그를 부르기 쉬운 습관을 찾아요. 고치면 코드를 읽고 고치기가 훨씬 쉬워져요.

if (count === 0) { /* ... */ }

const DEBUG = false;
function log(...a) { if (DEBUG) console.log(...a); }

try {
  save();
} catch (err) {
  console.error('저장 실패', err);
  showToast('저장하지 못했어요');
}

// (할 일은 이슈 목록에 적고 코드에서는 지우기)

function startGame() {
  setupBoard();
  placePlayers();
  startTimer();
}

// game/board.js · game/timer.js · game/save.js 처럼 나누기
import { setupBoard } from './board.js';

function give(user) {
  if (!user) return;
  if (!user.active) return;
  addReward(user);
}

function drawCard(card) { /* 같은 코드는 여기 한 번만 */ }
drawCard(a);
drawCard(b);

const max = 10;
let score = 0;

// 안 쓰는 줄은 지우기

try:
    value = int(text)
except ValueError:
    value = 0

🧹 안 쓰는 것 (아마도)

다른 파일 어디에서도 이름이 안 나오는 파일과 함수를 찾아요. 규칙만으로는 100% 알 수 없어서 "아마도"라고 표시해요. 지우기 전에 꼭 확인해 주세요.

// 쓰는 파일이라면 어디서 부르는지 분명하게
import { helper } from './helper.js';

// 안 쓰는 함수는 지우면 파일이 짧고 읽기 쉬워져요

📝 파일 설명

파일마다 규칙으로 짧은 소개를 만들어요. 언어와 줄 수, 불러오는 것(import·require·<script src>), 내보내는 것(export), 함수·클래스 목록, 맨 위에 적힌 설명 주석을 보여 주고, 폴더 이름과 내용으로 하는 일(화면, 스타일, 설정 파일, 시험 코드, 서버 API, Roblox 서버 스크립트 등)을 짐작해요.

처음 보는 프로젝트를 이해하거나, 내 프로젝트를 다른 사람에게 설명할 때 지도처럼 쓸 수 있어요.

🏅 점수는 이렇게 정해요

100점에서 시작해서 찾은 것마다 조금씩 빼요. 비밀 정보와 약한 곳은 많이, 흔한 실수와 안 쓰는 것은 조금만 빼요. 한 종류에서 빼는 점수에는 한도가 있어서, 작은 실수가 많다고 점수가 0이 되지는 않아요.

• A 90점 이상 — 아주 좋아요
• B 80점 이상 — 좋아요
• C 65점 이상 — 조금만 고쳐요
• D 50점 이상 — 고칠 곳이 꽤 있어요
• E 50점 아래 — 먼저 고쳐야 할 곳이 있어요

점수는 참고용이에요. 숫자보다 높음으로 표시된 것을 먼저 고치는 게 훨씬 중요해요.

❓ 자주 묻는 질문